Skrill 





Skrill Quick Checkout 
Integration Guide 


For use by Skrill eCommerce merchants using 
Quick Checkout 


This guide describes how to integrate with Skrill Quick Checkout. 


www.skrill.com 


Version 8.1 


Copyright 


O 2021. Skrill Ltd. All rights reserved. 


The material contained in this guide is copyrighted and owned by Skrill Ltd together with any other 
intellectual property in such material. Except for personal and non-commercial use, no part of this 
guide may be copied, republished, performed in public, broadcast, uploaded, transmitted, 
distributed, modified or dealt with in any manner at all, without the prior written permission of Skrill 
Ltd, and, then, only in such a way that the source and intellectual property rights are acknowledged. 


To the maximum extent permitted by law, Skrill Ltd shall not be liable to any person or organisation, 
in any manner whatsoever from the use, construction or interpretation of, or the reliance upon, all or 
any of the information or materials contained in this guide. 


The information in these materials is subject to change without notice and Skrill Ltd. assumes no 
responsibility for any errors. 


Skrill Ltd. 
Registered office: Skrill Limited, 25 Canada Square, Canary Wharf, London, E14 5LQ, UK. 


Version Control 


























Date Version Description 

September 2013 | 6.2 New guide template and updated content, including new Quick 
Checkout pages. 

October 2013 6.3 Changes to description of Payment Method Codes appendix. 

November 2013 | 6.4 Removal of Latvian currency. 

December 2013 | 6.5 Addition of credit card brands when passing payment methods, 
plus new screenshots. 

February 2014 6.6 Changes to Skrill 1-tap. 

May2014 6.7 Removal of Laser. Addition of Paysafecard. 

September 2014 | 6.8 New Quick Checkout pages and functionality. New structure to 


the guide. Addition of Trustly payment method code. 





November 2014 | 6.9 Addition of mobile wallet payment service and changes to 
screens, guide rewrite. 





January 2015 7.0 Changes made to the coverage of Visa Electron, JCB & Diners 





April 2015 71 Updated the URL for merchants to post transactions to https:// 
www .skrill.com/app/payment.pl 

Removed Slovakian Koruna, Estonian Kroon and Lithuanian Litas 
currencies from ISO 4217 currency table. 

Removed individual bank payment method codes for Poland and 
other minor updates to payment method codes. 





June 2015 72 Updated the Skrill Wallet section to show the new mobile 
optimised Wallet Checkout User Interface 

















Version Control 







































































Date Version Description 

November 2015 | 7.3 Described the new feature to allow merchants to calculate VAT/ 
Sales Tax. 

Added the Resurs and Alipay payment methods. 
Updated the URL for merchants to post transactions to https:// 
pay.skrill.com 

March 2016 7.4 Updated the Failed Reason Code table 
Added Neteller to the list of available payment methods. 

Added Alipay Customs Declaration call. 

June 2016 7.5 Added Straight Through Redirect support for Neteller payment 
method. Changed the list of supported countries based on the 
new Paysafe market presence policy. 

Added Astropay and Unionpay payment methods. 

ELV payment method renamed to SEPA. Payment logo changed. 
Skrill Direct method renamed Rapid Transfer. Payment logo 
changed. Poland added to list of supported countries. 

October 2016 7.6 Added the BitCoin payment method. Removal of Japan from list 
of supported countries. 

December 2016 | 7.7 Updated Astropay details. 

January 2017 7.8 Updated Trustly and Rapid Transfer supported countries. 

March 2017 7.9 Added MQI/API password and secret word to Table 2-2 on 
page 13. Added Peru Astropay information. Added failed reason 
code 67. 

July 2017 7.9 Added Denmark, Finland and Sweden to Rapid Transfer 
supported countries. 

Updated brand-centre URL and added failed reason codes 20, 68 
and 69. Updated other failed reason codes. 

August 2017 7.9 Added Norway to list of countries supporting Rapid Transfer. 

September 2017 | 7.9 Changed Sofort icon to Klarna. 

October 2017 7.9 Removed Banco de Occidente from Colombia. 

December 2017 | 7.9 Added iDEAL payment method GCI. 

January 2018 7.9 Added language support appendix. Corrected failure code 99. 

February 2018 7.9 Added Recurring Billing and Secure Restriction. Added Rapid 
Transfer mandatory field. 

March 2018 7.9 Added Colombian Peso as a handled currency. 

April 2018 7.9 Added Paysafecash as a payment method. 

December 2018 | 7.9 Added new sections to the Skrill 1-Tap Payments chapter. 

July 2021 8.0 Removed references to Bitcoin and UnionPay. 

Sep 2021 8.1 Updated four parameters in the guide. 








Publication number: GW-ECOM-H3-REL-10/22/21 





Skrill Quick Checkout Integration Guide 8.1 


Contents 
1; About this. GUIDO aparar tada ora SANS ie 1-1 
1.1. Objectives and target audience... 1-1 
12. let Ee E LTE 1-1 
1.3. Related documentation... 1-1 
1.4. Conventions used in this guide... 1-1 
1.5. Who to contact for queries iis neaei tetea a ei aea ai ieaiaia eta 1-2 
SM d ET TEEN 2-1 
2.1. Skrill payment How non nnnnnnnnnnnnnonnnnnnncnnnnnnnons 2-1 
2.2. Displaying Skrill as a payment option on your website... 2-2 
2.2.1 Display Pay by Skrill Jogos 2-2 
2.2.2 Display logos of specific payment methods .........ccccccccccccceecessessnseceeeeseessesssteeeeeeeees 2-3 
2.2.3 Logo restrictions for NON-EU Merchant .....cccccononoononnnnncnnnnnnnnononnnnnnnnnnononanonannnnnnnnos 2-3 
2.3. Redirecting customers to Quick Checkout ..........ss.ssssssssssesensersssssererrrssrsssserereesnsssseeneeess 2-4 
2.3.1 Secure redirection method ..........ecceccccessseececeenneaececeeseeeecesaaeeecseaeeeeeeaeeeeeeeqaeeeeseaas 2-4 
2.3.2 Secure redirection restriction. 2-5 
2.3.3 Parameters to be posted to Quick Checkout ires 2-5 
2.3.4 Test Cards and Test Merchant. 2-12 
2.4. The Quick Checkout page... 2-13 
2.4.1 Skrill transaction status... 2-14 
2.5. Skrill status response... 2-15 
2.5.1 Detailed: status: descriptions ccc.icccccsvecncadecsseeiceesueveeacecveiosekeds dae a ciación 2-18 
25.2 IER Te BEE 2-18 
2.6. Process for customers who are registered with Skrill ..............cooonncoocconnnccnnnnanooananonnnns 2-20 
2.7. Quick Checkout for out-of-region merchants 2-21 
2.8. Securing your Skrill Merchant account. 2-22 
2.8.1 Restricting access to your merchant account by IP address .........sssssnseseesesseseeee 2-23 
2:8:2 Skrill Security TOKEN BEE 2-23 
2.8.3 Additional security measures .........ccccccccccececcessessenseaeceeeeecesseaaaecaeeeesesssessaeaeeeeeens 2-24 
3. Skrill Digital Wallet PayMents.............csssssssssceccssssssssccccccnssssscecsscnssssssssssccseessscees 3-1 
3.1. Existing customers accessing their Skrill Wallet account... 3-1 
3.2. Customers who want to register for a Skrill account. 3-3 
4. Customizing the Quick Checkout Page ..........cccccssssssssccccccssssssceeccceessscsecesceesseseees 4-1 
4.1. Pre-populating payment feld: 4-1 
4.2. Displaying payment and order details. 4-3 
4.3. Preselecting or displaying payment methoden 4-4 
4.3.1 Fixed payment methods ....oooocccccncnccononoonnnnnnnnnnnnnnnnnnnnononnnnnnnnnnnnnnnnnnnonnnnnnnannnennnnnos 4-5 
4.3.1.1 Displaying specific credit/debit card brands .............. eee 4-6 
4.3.1.2 Straight Through Redirect cnni naiiai i a ai 4-8 
4.3.2 Flexible payment methods ........ooocccccononononocnnnnnnnnnnnononanonanonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnos 4-9 
4.4. Integrating Quick Checkout into your website... 4-10 
4.4.1 Displaying your company logo or brand... 4-10 
4.4.2 Embedding the Quick Checkout page 4-11 
4.4.3 Removing or reducing the header and reducing the footer. 4-13 
4.4.4 Recúrring DIME... econ tn tii 4-14 


O Skrill 2021 IV 


Skrill Quick Checkout Integration Guide 8.1 


5. Account and Integration Options. .............ssssccccssssssscceccccecsssscesceccessssseceeceeessssceees 5-1 
5:1. Secure return url patameter kees STEEN EAR ás 5-1 
5.2: MerchantirefuNdS sie DEE date a e lat di od E ose Saeed 5-2 
5.3. Chargeback nottfication. 5-2 
ele de TE 5-2 
5.5. Code integration example S. m rireerg s irinieaes anitis iei aes a eneen Ee aa E EAEE Eat ai 5-3 

5.5.1 Generating the Session ldentifler 5-3 
5.5.2 Redirecting the customer to Skill. 5-3 

6: Skrill 1-Tap Payment ses scavtavevesenienssedhabaassdssdnaerteceeadehvbatanseascdveeteansdece 6-1 
6.1 EnablingASTaps =. st OO 6-1 
6.2Enable:the MQ) and: API sessenta passos a ata 6-1 
6:3=Skrill-1=Tap:PUtton sema cae cdece ceed equi al dt a 6-3 
6.4: Call TIOWS visti ss man ince iii 6-3 
6.5. Setting up an initial 1-Tap payment iensen irete ai oaeaeei naani EEE E EE ETA 6-5 

6.5.1 Example of a Skrill 1-Tap payment form ......cccccnnnonooononcnnnonononanonanonnnnnncnnnnnonannnnnnnnos 6-6 
6.6. Taking subsequent 1-Tap pavments. 6-6 
6.621. Prepare payment: Sté piirini itna tee a aa ta ELE A cheats 6-7 
6.6.2 Execute payment step... NEEN a a a EN 6-11 
6.7. Checking or cancelling 1-Tap payments .........ccccccccccceccssssssssssseeeceesceeseseaeeeeeessesseeseaaees 6-13 
6.7.1 Cancel Skrill 1-'Tappavrment 6-13 
6.7.2 Get Skrill 1-Tap payment status ...oocoooccccnoconccccnnononcnonnnnnncnonano nono nnnn nc conan nn n cc nnannnnnos 6-14 
6:7-3 MOI Error Messages suicida Li A a a At hs acetate 6-16 

KO Te E EE 7-1 
7:1: Bank del Ee 7-2 
TD CaS N/N VOCE Ale sock eege a a ae RAS a Ad SE ebe 7-9 
PRETINA CPR AND RE Ar ee =P ge A A eege RR RR 7-12 
7.4. Astropay payment method code. 7-14 
7.5. List of banks supported by country ..... 7-14 

SAP aaa T 8-1 
6:12: ]50. 4217- ele ee 8-1 
ETS Le La EEN 8-2 
8.3. ISO country codes (3-digit) .............ooocconcccccconoooonnoccnnoanncnonnnononnnnnnncnnnnnanccnnnnnnnccnnnnnnnnnnnnos 8-3 
8:4. MDS Signature tt a AA Oa as eee ee 8-6 
8.5- TT E EE 8-7 
8.6. Example HTML ToRmMS assassinas tasa rua Dia nada dt did 8-7 
8:7. Payment method codes. asas dass suas A ars 8-9 

AN A caiacduecsadatsseczsaccess chakaseasaduiesucasvacedeckatesecsudion aa ee 8-11 

8.7.2 Alipay customs declaration ..........cccsesccccesssnceceeeeseeeeceeeeeeeceeseeeeeceseeeeeceseeeaeecseeaaees 8-12 

8.8. Failed reason CORES. ccccevveseciads aein ege eege geed luelasseladtacdeutecs 8-17 
Index 


© Skrill 2021 V 


Skrill Quick Checkout Integration Guide 8.1 


1. ABOUT THIS GUIDE 


1.1. Objectives and target audience 


This guide provides details on how to connect your website to Skrill Quick Checkout. It is intended for 
users who have a working knowledge of HTML. The guide covers the steps in the payment process 
and the information that needs to be passed from your web servers to Skrill, to enable Skrill to 
process payments. 


1.2. PCI disclaimer 


In accordance with the Payment Card Industry Data Security Standard in force as updated from time 
to time (“PCI-DSS”), Skrill will be responsible for the security of all Sensitive User Data (as defined in 
the Merchant Agreement) processed, stored or transmitted by Skrill when providing the Skrill 
Services. 


1.3. Related documentation 


You should use this guide together with the additional Skrill documents described below. 


Table 1-1: Other guides 








Guide Description 

Automated Payments and Describes how to connect to Skrill using the Automated Payments 

Merchant Query Interfaces Interface (API) and Merchant Query Interface (MAI). This supports 
Guide functionality such as merchant queries against the system, sending 


money and processing refunds. 
To download a copy of the Automated Payments and Merchant 
Query Interfaces Guide, click here. 














1.4. Conventions used in this guide 


The table below lists some of the conventions used in this guide. 


Table 1-2: List of conventions 





Convention Description 





Reference Indicates a reference to another section in this guide. For example, 
see Pre-populating payment fields on page 4-1. 











Code example Used to illustrate example code, functions and commands. 
File path Used for emphasis or to indicate a file path or field label. 
Menul > Menu option2 Indicates keys or controls that must be used during procedures. A 


chevron between items indicates that it is a menu path that you 
should select. 
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For all support queries, contact the Merchant Services department: 


Email: merchantservices@skrill.com 


Table 1-3: Contact numbers 

















Language Telephone number Operating times (weekdays) 
English +44 (0) 2083387760 8am - 5pm GMT 
English US +1 855 6225 167 8am - 6pm EST 
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2. INTRODUCTION 


Skrill Quick Checkout is a secure hosted payment page, where you can redirect customers from your 
website to make a payment through Skrill. Quick Checkout provides customers with access to a range 
of payment methods, based on their location and your account and integration settings. 


Integration to Quick Checkout is simple and requires collecting customer payment information on 
your website in a standard HTML form and submitting this to Skrill. Quick Checkout then collects the 
customer payment details needed to complete the payment, and sends these details to the relevant 
bank or alternative payment provider for authorisation. 


After the payment is complete, the customer is returned to your website and you receive a real-time 
notification of the payment, which includes details of the transaction. 


2.1. Skrill payment flow 


A simplified illustration of the Skrill payment flow is shown in the figure below. 


h — dê 


Customer Merchant 


E Engish 


Skein =D AMBIO! ve © 2 e le 


vsa SSS La 2 [3 


Card number 


| 


Expiry date Secunty code 6 
E — 
Cardholder name Skrill Payment Platform @ 
—— === 








John Payer 





Email address Why? Card Issuer 


g= Ska 


Figure 2-1: Skrill transaction flow 


1. When the customer is ready to pay for goods or services on your website, they select the 
Skrill payment option on your website. 


2. You request a session identifier (SID) by passing customer and transaction details (for 
example: amount, currency and language) to Quick Checkout. 


3. Skrill returns the generated SID. 


4. Using a light box or iframe you redirect the customer to Quick Checkout and include the 
session identifier in the redirect URL. Skrill displays the Quick Checkout page. 
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5. The customer enters their payment information, plus any other details requested, and 
confirms the transaction. 


6. Skrill requests authorisation for the payment from the customer's bank, third party provider 
or card issuer. 


7. The bank/provider approves or rejects the transaction. 
8. Skrill displays the Quick Checkout confirmation page, containing the transaction result. 


9. Skrill provides you with an asynchronous notification, sent to your status URL or IPN (instant 
Payment Notification), confirming the transaction details and status. 


2.2. Displaying Skrill as a payment option on your website 
When a customer is on the checkout page of your website, there are a number of ways in which you 
can present the Skrill payment options to them: 

e Display Pay by Skrill logos 


e Display logos of specific payment methods 


2.2.1. Display Pay by Skrill logos 

The simplest integration option is to present a generic Pay by Skrill logo or button on your website, 
and then redirect the customer to the Skrill Quick Checkout page, where they can pay using a suitable 
method or log in to their Skrill account to pay from their account balance. This integration option 
ensures that your customers always have access to the full range of Skrill payment methods available 
in their country or region. 


See the example logos below. 


Skrill Skrill 


You can download a copy of these logos in different sizes from the Skrill Website at: 
https://www.skrill.com/en/merchants/brand-centre 


Note: You will need your Skrill Account customer ID to use this section of Skrill.com, see https:// 
help.skrill.com/en/Article/my-money/deposits/how-do-i-locate-my-customer-id-number for 





details. 
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2.2.2. Display logos of specific payment methods 
An alternative option is to present only the logos of the specific payment methods you want to offer 
your customers through Skrill. For example: 


O. 
E PEA) Przelewy ER E d 


You can then define, in your HTML code, which payment method to display on the Skrill Quick 
Checkout page when the customer selects this logo. There are two ways in which this feature can be 
implemented: 


e Fixed - only the selected payment method (or methods) is (are) displayed to the customer on 
Quick Checkout. The first method supplied is preselected (set as the default option). 


e Flexible - the selected payment method is displayed as the default option (preselected). Skrill 
automatically detects the customer’s country (using Geolocation or the country parameter 
passed by the merchant) and displays a localized version of the Quick Checkout page. Only 
the payment methods available in the customer’s country are displayed. The order of the 
payment methods tabs is based on the popularity and conversion rate for each method in the 
customer’s country. 


Co-branded payment method logos for display on your website are available at: 
https://www.skrill.com/en/merchants/brand-centre 


Note: The Payment methods you want to support are specified by including the relevant payment 
method codes in the payment request submitted to Skrill. Alternatively, it is also possible to 
request that only specific payment methods be enabled. For details, please contact Skrill 
Merchant Services. 


2.2.3. Logo restrictions for non-EU merchants 


Note: Read this section carefully if your business is located outside of the EU/EEA or the US. 


For Skrill merchants based outside of the US and EU/EEA, Visa and MasterCard logos or brand names 
must not be used in the payment button that links to Skrill. 


The Skrill processing agreement does not give you rights to display Visa and MasterCard acceptance 
marks on your site, and these logos should not be displayed unless you have obtained the rights to do 
so under a separate processing agreement. 


Our compliance team conduct regular checks to ensure that this rule is enforced and failure to 
comply may result in suspension of your account. 


For more information, see Quick Checkout for out-of-region merchants on page 2-22. 
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2.3. Redirecting customers to Quick Checkout 


You can use a standard HTML form to collect and pass payment and customer details to Quick 
Checkout. See Example HTML forms on page 8-7. When the customer selects the Skrill option, your 
website should post the HTML form containing their transaction details to: 


https://pay.skrill.com . 
The HTML form should contain the mandatory hidden input fields listed in Table 2-1 on page 2-5. 


You should use a secure method of obtaining a session ID before redirecting customers to Skrill, as 
described in Secure redirection method on page 2-4. 


Tips for improving the customer experience 


e Any parameters that you pass through in your HTML form, such as customer first name, last 
name, and email, will be automatically populated (or populated and hidden) as appropriate, 
on the Quick Checkout payment pages making it easier for the customer to complete these 
forms. 


e Youcan customize the appearance of the Quick Checkout page using the options described in 
Chapter 4: Customizing the Quick Checkout Page. 


e To maximise conversion, Skrill recommends that you redirect customers to the Quick 
Checkout page in the same browser window or embed the Skrill page in an iframe (see 
Embedding the Quick Checkout page on page 4-11). 


2.3.1. Secure redirection method 
This method can be used to ensure that details of the payment are communicated securely between 
your server and Skrill. 


Note: Important! We strongly recommend that you use this method when redirecting your 
customers to Skrill, as it does not require sending any payment parameters to their browser. 
This prevents customers from being able to view or modify any hidden parameters in your 
source code. 


The redirection process is as follows: 


1. Your web server makes a standard POST request with the payment parameters, using the 
“prepare only=1" parameter (see Table 2-1 below). 


2. The Skrill server prepares a session for the payment and returns a standard HTTP(S) response. 
3. Your web server takes the body of the response which contains a SESSION_ID value. 


4. Using this SESSION ID value the customer can be redirected to: 
https://pay.skrill.com/?sid=<SESSION ID> 


The normal flow of events continues. This redirect must happen within 15 minutes of the original 
request or the session will expire. 
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Note: The Skrill Payment Platform treats GET/POST requests to the payment URL identically. As a 
result, you can also use an HTTP GET operation in place of POST in step 1 above and pass the 
payment parameters as name/value pairs in the query string. Similarly, in Step 4 above you 
could use a HTTP POST operation and pass the SESSION ID value from Step 3 as the sid 
parameter in the message body. 


For code examples of how to implement this, see Redirecting the customer to Skrill on page 5-3. 


2.3.2. Secure redirection restriction 

The Quick Checkout Secure Restriction service allows merchants to create a whitelist of IP addresses 
(including ranges) specific to them, so that Gateway transactions are generated only for the IP 
addresses in the list. When the service is enabled and the list is populated, any request that doesn't 
have a “SID” in Skrill will be blocked. By default, the service is disabled, and the Gateway allows all 
payment requests, with no restrictions. 


Configure the service as follows: 


Note the IP addresses/address ranges to add to the whitelist. 
Log in to your merchant account. 


1 
2 
3. Goto Settings > DEVELOPER SETTINGS. 
4 


Under Quick Checkout Secure Restriction, set Enable service, and then, in the field below, 
type the IP addresses separated by spaces, or an address range in CIDR notation. 


5. Click Save. 
2.3.3. Parameters to be posted to Quick Checkout 


Please review the table below for details of the required and optional parameters that need to be 
included in your form. For implementation examples, see Example HTML forms on page 8-7. 


Note: All URL parameters must include the scheme at the front of the URL for example: https://. For 
example instead of www.google.co.uk you would need to use https://www.google.co.uk. 


Table 2-1: Skrill Quick Checkout parameters 


























Field name Description Required 4 SC Example value 

Merchant details 

pay to email Email address of your Skrill Yes 50 info@example.com 
merchant account. 

recipient_description | A description to be shown on the No 30 Your Company Name 


Skrill payment page in the logo area 
if there is no logo_url parameter. If 
no value is submitted and there is no 
logo, the pay_to_email value is 
shown as the recipient of the 
payment. (Max 30 characters) 
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Field name 


Description 


Required 


Max 
length 


Example value 





transaction id 


Your unique reference or 
identification number for the 
transaction. (Must be unique for 
each payment) 


No 


100 


A205220 





return url 


URL to which the customer is 
returned once the payment is made. 
If this field is not filled, the Skrill 
Quick Checkout page closes 
automatically at the end of the 
transaction and the customer is 
returned to the page on your 
website from where they were 
redirected to Skrill. A secure return 
URL option is available. (See Secure 
return url parameter on page 5-1.) 


No 


240 


https:// 
www.example.com/ 
payment.htm 





return url text 


The text on the button when the 
customer finishes their payment. 


No 


35 


Return to main 
website 





return url target 


Specifies a target in which the 
return url value is displayed upon 
successful payment from the 
customer. Default value is 1. 

1=' top' 

2 =" parent' 

3=' self 

4='" blank 


No 


3 





cancel url 


URL to which the customer is 
returned if the payment is cancelled 
or fails. If no cancel URL is provided 
the Cancel button is not displayed. 


No 


240 


https://example.com 
/payment 
cancelled.htm 





cancel url target 








Specifies a target in which the 
cancel url value is displayed upon 
cancellation of payment by the 
customer. Default value is 1. 


1=' top' 

2 ='_parent' 
3=' self 
4='_blank' 





No 
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Field name 


Description 


Required 


Max 
length 


Example value 





status url 


URL to which the transaction details 
are posted after the payment 
process is complete. Alternatively, 
you may specify an email address 
where the results are sent. 

If the status urlis omitted, no 
transaction details are sent. 


Only the following ports are 
supported: 

80, 81, 82, 83, 88, 90, 178, 419, 433, 
443, 444, 448, 451, 666, 800, 888, 
1025, 1430, 1680, 1888, 1916, 1985, 
2006, 2221, 3000, 4111, 4121, 4423, 
4440, 4441, 4442, 4443, 4450, 4451, 
4455, 4567, 5443, 5507, 5653, 5654, 
5656, 5678, 6500, 7000, 7001, 7022, 
7102, 7777, 7878, 8000, 8001, 8002, 
8011, 8014, 8015, 8016, 8027, 8070, 
8080, 8081, 8082, 8085, 8086, 8088, 
8090, 8097, 8180, 8181, 8443, 8449, 
8680, 8843, 8888, 8989, 9006, 9088, 
9443, 9797, 10088, 10443, 12312, 
18049, 18079, 18080, 18090, 18443, 
20202, 20600, 20601, 20603, 20607, 
20611, 21301, 22240, 26004, 27040, 
28080, 30080, 37208, 37906, 40002, 
40005, 40080, 50001, 60080, 60443 
These port restrictions apply to all 
Skrill status urls 


No 


400 


https:// 
example.com/ 
process ` 
payment.cqi 


OR 
mailto: 
info@example.com 





status_url2 


Second URL to which the transaction 
details are posted after the payment 
process is complete. Alternatively, 
you may specify an email address 
where the results are sent. The 
same port restrictions apply as for 
the status_url parameter above. 


No 


400 


https://example. 
com/process | 
payment 2.cqi 


OR 
mailto: 
info@example.com 





language 


2-letter code of the language used 
for Skrill’s pages. Can be any of the 
codes in Language support on 
page 8-2. 


No * 
See Note 
1 


EN 





psp_id 








Identification of the shop which is 
the originator of the request. This is 
most likely used by the payment 


service providers who act as a proxy 
for other payment methods as well. 


No 








16 





A205220 
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Field name 


Description 


Required 


Max 
length 


Example value 





submerchant id 


Identification of the shop which is 
the originator of the request. This is 
most likely used by the payment 


service providers who act as a proxy 
for other payment methods as well. 


No 


120 


Payment service 
provider name 





submerchant name 


The merchant name listed on the 
website for which the payment is 
made 


Applicabl 


e for 
resellers 


240 


Example LTD 





submerchant url 


URL of the website for which the 
payment is made. 


Applicabl 


e for 
resellers 


240 


http:// 
www.example.com 





logo_url 


The URL of the logo which you 
would like to appear in the top right 
of the Skrill page. The logo must be 
accessible via HTTPS or it will not be 
shown. 

The logo will be resized to fit. To 
avoid scaling distortion, the 
minimum size should be as follows: 


e If the logo width > height - at 
least 107px width. 


e If logo width > height - at least 
65px height 


Avoid large images (much greater 
than 256 by 256px) to minimise the 
page loading time. 


No 


240 


https:// 
www.example.com/ 


logo.jpg 





prepare_only 








Forces only the SID to be returned 
without the actual page. Useful 
when using the secure method to 
redirect the customer to Quick 
Checkout. For details, see Secure 
redirection method on page 2-4. 
Accepted values are 0 (default) and 
1 (prepare only). 


No 
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Field name 


Description 


Required 


Max 
length 


Example value 





dynamic descriptor 


When a customer pays through 
Skrill, Skrill submits a preconfigured 
descriptor with the transaction, 
containing your business trading 
name/ brand name. The descriptor 
is typically displayed on the bank or 
credit card statement of the 
customer. For Klarna and Direct 
Debit payment methods, you can 
submit a dynamic descriptor, which 
will override the default value 
stored by Skrill. See Adding a 
descriptor on page 5-2 for more 
details. 


No 


ACME Solutions Ltd. 





sid 


This is an optional parameter 
containing the Session ID returned 
by the prepare only call. If you use 
this parameter you should not 
supply any other parameters. 


No 


32 


Oeb5dof6b94badfeae 
5b0364b26d0288 





rid 


You can pass a unique referral ID or 
email of an affiliate from which the 
customer is referred. The rid value 

must be included within the actual 

payment request. 


No 


100 


123456 





ext refiid 


You can pass additional identifier in 
this field in order to track your 
affiliates. You must inform your 
account manager about the exact 
value that will be submitted so that 
affiliates can be tracked. 


No 


100 


Affiliate Name 





merchant fields 


A comma-separated list of field 
names that are passed back to your 
web server when the payment is 
confirmed (maximum 5 fields). 


No 


240 


Field1,Field2 





Field1 


An example merchant field 


No 


240 


Value 1 





Field2 


An example merchant field 


No 


240 


Value 2 





Customer details (used 


to speed up Registration or Payment) 





pay_from_email 


Email address of the customer who 
is making the payment. If provided, 
this field is hidden on the payment 
form. If left empty, the customer has 
to enter their email address. 


No * 
See Note 
2 


100 


payer@skrill.com 





firstname 








Customer’s first name. 


No * 
See Note 
2 








20 





John 
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A SE A Max 
Field name Description Required erat Example value 
lastname Customer's last name No * 50 Payer 
See Note 
2 
date of birth Date of birth of the customer. The No 8 01121980 
format is ddmmyyyy. Only numeric 
values are accepted. 
If provided this field will be prefilled 
in the Payment form. This saves time 
for SEPA payments and Skrill Wallet 
sign-up which require the customer 
to enter a date of birth. 
address Customer’s address (for example: No 100 Payer street 
street) 
address2 Customer’s address (for example: No 100 Payer town 
town) 
phone_number Customer’s phone number. Only No 20 0207123456 
numeric values are accepted 
postal_code Customer’s postal code/ZIP Code. No 9 EC45MQ 
Only alphanumeric values are 
accepted 
(for example:, no punctuation marks 
or dashes) 
city Customer’s city or postal area No 50 London 
state Customer’s state or region. No 50 Central London 
country Customer’s country in the 3-digit ISO | No 3 GBR 
Code (see ISO country codes (3- 
digit) on page 8-3). 
neteller_account Neteller customer account email or No 150 netellertest_GBP@n 
account ID eteller.com 
neteller_secure_id Secure ID or Google Authenticator No 411392 
One Time Password for the 
customer’s Neteller account 
Payment details 
amount The total amount payable. Yes 19 39.68 
Note: Do not include the trailing OR 
zeroes if the amount is a natural 39.6 
number. For example: “23” (not OR 
“23.00"). 39 
currency 3-letter code of the currency of the Yes 3 EUR 
amount according to ISO 4217 (see 
ISO 4217 currencies on page 8-1). 
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Field name 


Description 


Required 


Max 
length 


Example value 





amount2 description 


You can include a calculation for the 
total amount payable, which is 
displayed in the More information 
section in the header of the Skrill 
payment form. 

Note that Skrill does not check the 
validity of this data. 


No 


240 


Product price: 





amount2 


This amount in the currency defined 
in the field ‘currency’ will be shown 
next to amount2_description. 


No 


19 


29.90 





amount3_description 


See above 


No 


240 


Handing fees & 
charges: 





amount3 


See above 


No 


19 


3.10 





amount4_description 


See above 


No 


240 


VAT (20%): 





amount4 


See above 


No 


19 


6.60 





detail1_description 


You can show up to five additional 
details about the product in the 
More information section in the 
header of Quick Checkout. 


No * 
See Note 
1 


240 


Product ID: 





detail1_text 


The detail1_text is shown next to 
the detail1_description in the More 
Information section in the header of 
the payment form with the other 
payment details. The 
detail1_description combined with 
the detail1_text is shown in the 
more information field of the 
merchant account history CSV file. 
Using the example values, this 
would be Product ID: 4509334. 
Note: If a customer makes a 
purchase using Skrill Wallet this 
information will also appear in the 
same field in their account history. 


No * 
See Note 
1 


240 


4509334 





detail2_description 


See above. Note not shown in the 
account history. 


No 


240 


Description: 





detail2_text 


See above. Note not shown in the 
account history. 


No 


240 


Romeo and Juliet 
(W. Shakespeare) 





detail3_description 


See above. Note not shown in the 
account history. 


No 


240 


Special Conditions: 





detail3_text 


See above. Note not shown in the 
account history. 


No 


240 


5-6 days for delivery 





detail4_description 








See above. Note not shown in the 
account history. 


No 








240 
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Max 
Field nam Description Requir Example val 
eld name escriptio equired Ene ample value 
detail4 text See above. Note not shown in the No 240 
account history. 
detail5 description See above. Note not shown in the No 240 
account history. 
detail5 text See above. Note not shown in the No 240 
account history. 





Note: 1.) language, detaill text and detaill description are not mandatory but are highly 
recommended for a good user experience. English is used as the default language if no 
Language is provided. 
2.) When using Rapid Transfer, if a customer is to be passed for a straight through redirect, the 
following parameters are mandatory: firstname, lastname, pay from email. 


Language Encoding for Text Parameters 


All text fields use UTF-8 encoding. Note however that the Quick Checkout payment form can only 
display Latin-1 characters. 
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2.3.4. Test Cards and Test Merchant 


You may wish to test the Quick Checkout. You can use our test page at https://www.skrill.com/app/ 
test payment.pl to access the payment form parameters. Set the pay to email parameter under 


Merchant Details to a test merchant account for example: demoqco@sun-fish.com. Set any other 
parameters as required and click Submit to load Quick Checkout. 


Table 2-2: Test merchant accounts 





Merchant account MQI/API password and secret word | Type 





demoqco@sun-fish.com mai: skrill123, secretword: skrill Fixed Payment Options (Fixed 
Split Gateway) 





demogqcoflexible@sun-fish.com | mqi: skrill123, secretword: skrill Flexible Payment Options 
(Flexible Split Gateway) 





demogqcofixedhh@sun-fish.com | mqi: skrill123, secretword: skrill Fixed Payment Options (Fixed 


Split Gateway) with Reduced 
header option enabled. 

















Warning: This is the live production payment form. If you use a standard (non-test) pay to email 
merchant account and a valid credit card or standard Skrill account the payments will be 
processed and deducted from your card or Skrill wallet. 


We provide three test cards shown in the table below for use with the test merchant. When using 
these card numbers enter an expiry date in the future and a random CVV number. 


Table 2-3: Test cards 





Brand Card number 





Mastercard 5438311234567890 





Visa 4000001234567890 
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2.4. The Quick Checkout page 


The Skrill Quick Checkout page displays the payment details submitted to Skrill, as shown in the 
example below. 


& English 
AMOUNT AND 


CURRENCY ~ 39.60ur A ACME 


MERCHANT LOGO 


PAYMENT 


—| CUSTOMER CAN SEE 
METHODS IN TABS ————— | == "TE a 
=p | RAPID EA u OTHER PAYMENT 
SCS METHODS 
AVAILABLE CARD ——— —— D } 
VISA 
o Scot 2 > 
Card number 
Expiry date Security code 
Cardholder name 
CUSTOMER Jöhñ Payer 
COMPLETES 
MANDATORY FIELDS 
Email address Why? 


Norton Powered by 
g Skrill 
Figure 2-2: Example of Skrill payment page 


The customer enters their credit card details and email address, and selects Pay Now to confirm the 
payment. 


At any time before the Pay Now button is selected, the customer can cancel the payment process and 
return to your website (to the URL provided in the 'cancel_url' field; see Table 2-1 on page 2-5). 


Notes 


e The Quick Checkout payment page can be customized, as described in Chapter 4: 
Customizing the Quick Checkout Page. 


e Customers who have an existing Skrill account can log in to their account to make payments, 
as described in Chapter 3: Skrill Digital Wallet Payments. 


e Credit and debit card brands are not displayed on Quick Checkout for merchants who are 
based outside of Skrill's standard region (USA and EU/EEA). For more information, see Quick 
Checkout for out-of-region merchants on page 2-22. 
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2.4.1. Skrill transaction status 
When the payment process is completed the “Successful payment” message is displayed: 


& English 


9.00 eur 0 


J 





Successful payment 


will appear on your bank 





nt as SKR*Skrill.com 


Norton i Powered by 


sca Skrill 


powered by VeriSign 


Figure 2-3: Transaction status 
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2.5. Skrill status response 


When the payment process is complete Skrill sends the details of the transaction to the status url 

page you provided in your payment request (see Table 2-1 on page 2-5). This is done with a standard 
HTTP POST. The Skrill server continues to post the status until a response of HTTP OK (200) is received 
from your server or the number of posts exceeds 10. 


The table below shows the parameters sent to your status url page: 


Table 2-4: Status URL parameters 





Field name 


Description 


Required 


Example value 





pay to email 


Your email address. 


Yes 


info@merchant. com 





pay from email 


Email address of the customer who is 
making the payment. 

Note: If a Skrill wallet account exists 
with this email, and the Skrill Wallet is 
one of the available payment method 
tabs, it will be selected as the default 
payment method) 


Yes 


payer123 @skrill.com 





merchant_id 


Unique ID of your Skrill account. ONLY 
needed for the calculation of the MD5 
signature (see MDS signature on 
page 8-6). 


Yes 


100005 





customer_id 


If the customer pays using a Skrill 
Wallet, this is the unique ID of their 
Skrill account. 

If the customer pays with any other 
payment method, this is a unique ID 
for this payment generated by Skrill 


No? 


200005 





transaction_id 


A unique reference or identification 
number provided by you in your HTML 
form. 


No 


A205220 





mb_transaction_id 


Skrill’s internal unique reference ID for 
this transaction 


Yes 


170032056 





mb_amount 


The total amount of the payment in 
the currency of your merchant Skrill 
digital wallet account. 


Yes 


25.46 / 25.4 /25 





mb_currency 


Currency of mb_amount. Will always 
be the same as the currency of your 
merchant Skrill digital wallet account. 


Yes 


GBP 





status 


Status of the transaction: -2 failed / 2 
processed / O pending / -1 cancelled 
(see detailed explanation below) 


Yes 





failed_reason_code 








If the transaction has a status value -2 
(failed), this field will contain a code 
detailing the reason for the failure. 
Note that you will need to ask Skrill to 
enable this feature to receive the 
code. 





No € 





06 
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Table 2-4: Status URL parameters (Continued) 





Field name 


Description 


Required 


Example value 





md5sig 


MDS signature (see MD5 signature on 
page 8-6). 


Yes 


327638C253A4637199CEBA 
6642371F20 





sha2sig 


SHA2 signature (see SHA2 signature 
on page 8-7). 


No Y 


dbb7101322257a311f08d1c 
527053058fc7e464e30bcfb 
4613f09053c22dd1f8 





amount 


Amount of the payment as posted in 
your HTML form. 


Yes 


39.60 / 39.6 / 39 





currency 


Currency of the payment as posted in 
your HTML form. 


Yes 


EUR 





neteller_id 


If the Neteller payment method is 
used this parameter contains the 
Neteller customer's account id or 
email depending on the details 
entered by the Neteller customer or 
the value supplied in the 
neteller_account parameter. 


No 


netellertest_GBP@neteller. 
com 





payment_type 


The payment method the customer 
used (see Payment method codes on 
page 8-9). Contact merchant services 
to enable this option. You can choose 
to receive either: 


e Consolidated values - there are 
two values that can be shown: 
WLT for Skrill account balance 
payments and MDB for any other 
payment type for example: 
credit/debit card or alternative 
payment method. Note that if 
the customer logs in to their Skrill 
Wallet but pays by Card the MDB 
value will be used. 


e Detailed values - this shows the 
specific instrument used, for 
example, VSA - Visa card, GIR — 
giropay, and so on. WLT stands 
for Skrill account balance in this 
context. Note that if the 
customer logs in to their Skrill 
Wallet but pays using a saved 
Visa Card the VSA payment code 
will be returned. 


No € 


WLT 





merchant fields 








If you submitted a list of values in the 
merchant fields parameter, they will 
be passed back with the status report. 





No 





field1=value1 





a. The customer_id parameter is enabled upon activation. If you don’t receive it in the response sta- 
tus, please contact Skrill Merchant Services. 

b. If no transaction_id is submitted, the mb_transaction_id value will be posted in the report. 

c. The failed_reason_code parameter is enabled upon activation and is part of the response status. 
For a description of all failed reason codes, see Failed reason codes on page 8-17. 
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d. To enable the sha2sig parameter, contact merchant services. For more information, see SHA2 sig- 
nature on page 8-7. 

e. The payment type parameter is enabled upon activation. If you don't receive it in the response sta- 
tus, please contact Skrill Merchant Services. 


Language encoding for text parameters 


All text fields use UTF-8 encoding. Note however that the Quick Checkout can only display Latin-1 
characters. 


Validating the status response 


We recommend that you validate the transaction details in the status response. This can be done as 
follows: 


1. Create a pending transaction or order for a fixed amount on your website. 


2. Redirect the customer to the Quick Checkout page, where they complete the transaction. 


3. Skrill will post the transaction confirmation to your status url page. This will include the 
mb amount (amount) parameter. 


4. Your website should validate the parameters received by calculating the md5 signature (see 
MDS signature on page 8-6). If successful, it should compare the value in the confirmation 
post (amount parameter) to the one from the pending transaction or order on your website. 
You can also compare other parameters such as transaction id and pay from email. 


Once you have validated the transaction data you can process the transaction, for example, by 
dispatching the goods ordered. You must implement measures to ensure that goods are not 
dispatched multiple times if you receive subsequent successful notifications for the same transaction 
ID (transaction id or mb transaction id) to protect against replay attacks or other sources of 
duplicate status posts. 


Note: If you want to restrict the receipt of status response based on the posting IP address, you 
should use the full list of Skrill IP ranges as from time to time Skrill may change the IP address 
used. Any address within any of the following listed ranges could be used. The full list of Skrill IP 
ranges are: 91.208.28.0/24, 93.191.174.0/24, 193.105.47.0/24, 195.69.173.0/24. 


Using the Merchant Query Interface 


You can use the Merchant Query Interface to repost a status report, to automatically check the status 
of a transaction, and to issue a refund to a customer. For details, see the Automated Payments and 
Merchant Query Interfaces Guide. 
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2.5.1. Detailed status description 


Table 2-5: Transaction status 





# Status Description 





‘2’ Processed Sent when the transaction is processed and the funds have been received in 
your Skrill account. 





‘0’ Pending Sent when the customers pays via an offline bank transfer option. Such 
transactions will auto-process if the bank transfer is received by Skrill. 

Note: We strongly recommend that you do not process the order or transaction 
in your system upon receipt of this status from Skrill. 








Y” Cancelled Pending transactions can either be cancelled manually by the sender in their 
online Skrill Digital Wallet account history or they will auto-cancel after 14 days 
if still pending. 

‘-2’ Failed This status is typically sent when the customer tries to pay via Credit Card or 


Direct Debit but our provider declines the transaction. It can also be sent if the 
transaction is declined by Skrill’s internal fraud engine for example: 
failed_reason_code 54 - Failed due to internal security restrictions. For a 
description of all failed reason codes, see Failed reason codes on page 8-17. 





3 Chargeback Whenever a chargeback is received by Skrill, a ‘-3” status is posted in the 
status_url and an email is sent to the primary email address linked to the 
Merchant’s account. Skrill also creates a new debit transaction to debit the 
funds from your merchant account. 

















2.5.2. Sales tax/VAT option 


Skrill provides a configuration setting to assist merchants to calculate sales/value added tax (VAT). 
Contact merchant services to enable this option. Once enabled, the following three additional 
parameters are sent as part of the status response to the status_urls: 


Table 2-6: Sales tax status_url parameters 





Parameter Description 





payment_instrument_ | A three letter ISO 3166-1 alpha-3 code showing the country of origin of the 
country payment instrument the customer used. For example, a Visa card for a bank in 
Germany would return DEU. This value will be blank if no country can be 
determined for the payment method. If the customer pays using their Skrill wallet 
balance the payment_instrument_country will be the same as the country 
registered for their Skrill account 





country A three letter ISO 3166-1 alpha-3 country code. If a country parameter is passed to 
the payment form this value will be used. If customer pays using a Skrill Wallet the 
country they selected when registering their Skrill account is returned. If none of 
these situations apply geolocation (using the customer’s IP) is used to return a 3 
character country code. 





IP_country A two letter ISO 3166-1 alpha-2 code showing the customer's country as 
determined by Geolocation using the customer's IP. 














These values are also added to the CSV account history report. This report can be obtained using the 
view account history Merchant Query Interface option or via the All Transactions > Export CSV option 
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in the My account section after logging in to your merchant Skrill account. The following table shows 
the column names for these parameters in the CSV file: 


Table 2-7: CSV parameters 





Status, url parameter 


CSV column name 





payment instrument country 


Instrument Country 




















L 


Product ID: 4509334 


Product ID: 4509334 


Product ID: 4509334 


Product ID: 4509334 


Product ID: 4509334 


country Country 
IP country IP country 
E F G H I J K 
i [-] USD [+] USD Status Balance Reference Amount Currency More Information 
e 0.2 processed 167479.3 
ligits@sun-fish.com 43.571611 processed 167480.8 171.83 PLN 
1.263577 processed 167479.5 
sh.com 44.51832 processed 167506.7 39.6 EUR 
1.291031 processed 167505.4 
e 0.22484 processed 167505.2 
ligits@sun-fish.com 43.308899 processed 167548.5 39.6 EUR 
1.255958 processed 167547.3 
e 0.9 processed 167546.4 
ligitsQsun-fish.com 43.532977 processed 167589.9 39.6 EUR 
1.262456 processed 167588.6 
e 0.2 processed 167588.4 
1.278142 processed 167631.2 
e 0.9 processed 167630.3 
ligits@sun-fish.com 44.073856 processed 167632.5 39.6 EUR 


Figure 2-4: Section of Account History CSV file with Sales Tax fields highlighted in red 
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2.6. Process for customers who are registered with Skrill 


Customers who have already registered for a Skrill Digital Wallet account can log in to their account 
and pay from the available balance in their account. They can also pay using one of the payment 
methods linked to their account, or access additional Skrill payment methods and options. 


e To log in to their account the customer selects the Pay by Skrill tab. The following page is 
displayed: 


A8. Dous © A ACME 


Pay by 


Stat =D) PAPI) so O 


Skrill account 


Email address 
ENTER EMAIL ADDRESS 


Password Forgot? 
ENTER PASSWORD 


on't have an account? Sign up 


Pay 


vs Gë E BH WW = 
Norton Powered by 
g Skrill 


Figure 2-5: Pay by Skrill tab 


The customer enters their Skrill account email address and password; they then select the Login 
button. 


For more information on how customers can access their Skrill Digital Wallet account, and the options 
available through the Skrill Digital Wallet, see Chapter 3: Skrill Digital Wallet Payments. 
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2.7. Quick Checkout for out-of-region merchants 


Please read this note carefully if your business is based outside of the USA and the EEA (all EU 
Member States, Iceland, Liechtenstein and Norway) or in Andorra, Gibraltar, Monaco, San Marino, 
Switzerland, Turkey, Vatican. Skrill’s standard payment processing region). The Skrill processing 
agreement does not give you the rights to display Visa and MasterCard acceptance marks on your 
website. 


To comply with card scheme regulations, Skrill has removed the credit card brands displayed to 
customers on the Quick Checkout payment form and added an additional introductory screen as 
shown below. However, customers are still able to click Pay as a Guest and enter their credit or debit 
card details and pay. 


& English 


Skrill account 
Email address 
| sample.payer@skrill.com 


Password Forgot? 


LOGIN 


Pay with your credit or debit card 


eate a ACcou 


PAY AS A GUEST 


Don't have an account? Sign up 
D | yiti j + r er ail ind pas N rd 


] 


va O) E Mp» = 


Cancel 
(O Skrill 
Figure 2-6: Out-of-region Quick Checkout introductory screen 


Alternatively, customer's can or log in/sign-up for a Skrill Wallet account from the introductory 
screen. 
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The Out of Region Quick Checkout payment form also features an additional text description above 


the PAY NOW button, which links to the Skrill Guest and Skrill Privacy policy. See the example below: 


ab English United Kingdom 


39 6QcEvR O 
=D) Skrill 402/05 muer 


Log in to complete the payment 


Email address 


Password Reset password 


y 


LOG IN 


Privacy Policy | | 
Don't have an account? Sign up 


Pay safely with just an email and password 


PCI DSS 


Skrill Compliant 


Figure 2-7: Quick Checkout for out-of-region merchants 


2.8. Securing your Skrill merchant account 


It is important to secure your Skrill merchant in case your account password is compromised. Skrill 
provides three main methods to enhance the security of your account: 


e Restricting access to your merchant account to a specific IP address or a list of IP addresses. 


e Google two-factor authentication using a mobile device (Android or Apple devices are 
supported). 


e The Skrill hardware security token. 
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Skrill recommends that you use methods 1 and 2 to secure your account. Alternatively, you can use 
methods 1 and 3. You cannot use the hardware token together with Google two-factor 
authentication. These methods are described in detail in the following pages. 


2.8.1. Restricting access to your merchant account by IP address 

This is only useful if your ISP provides you with a static IP address or addresses. If the machine(s) that 
you use to log in have dynamically allocated IP addresses you will not be able to use this method to 
secure your account. 


Configure this option as follows: 


1. Locate your IP address/addresses/address range used by the machines you wish to use to 
access your Skrill merchant account 


1. Log into your merchant account 


2. Goto Settings > Developer Settings > API / MAI / GSR / CVT Management > Gateway Secure 
Restriction (GSR) 


Click Add and enter an IP address. 
Click Save 


Log out of your account. The restrictions are now active. 


Sr: At p w 


Test that you can log in to your account from the machine/machines that you wish to use and 
that you are unable to log in from a machine with a different IP address. 


Gateway Secure Restriction (GSA) Disabled » 


Warning: If you choose to restrict login to an IP range, use the smallest possible address range. Do 
not specify a range large than 256 IP addresses. 


2.8.2. Skrill Security Token 


The Skrill Security Token is a device that generates one-time, unique passwords to provide two-factor 
authentication. Once the security token is enabled, you will be prompted to use the token to 
generate a new one-time password when logging in to your account. You can have more than one 
token per account to allow multiple users in different locations to access the merchant account. 


Note: You will still need to enter your standard account password. 
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See this linked help hub article for more details, including information about ordering the token. 


2.8.3. Additional security measures 

If you are not planning to use the manual send money feature to transfer funds to other Skrill 
accounts, you can contact Skrill Merchant Services to ask them to disable this feature. Automated 
money transfers using the Skrill Automated Payment Interface are disabled by default. 
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3. SKRILL DIGITAL WALLET PAYMENTS 


Additional payment options are available to customers who choose to register for or pay with their 
existing Skrill Digital Wallet account. You can enable the Skrill Wallet payment option using the WLT 
payment code as part of the payment methods value field. For example: 


<input type="hidden" name="payment methods" value="WLT, ACC"> 
3.1. Existing customers accessing their Skrill Wallet account 


A registered customer can click the Pay by Skrill tab, enter their user name and password, and select 
the Login button (see Pay by Skrill tab on page 2-21). 


If the customer already has credit or debit cards configured in their Skrill account, they are given the 
option to select one of these cards to pay as follows: 


Welcome | Logout 


1.QQEvR o A ACME 


= Sg E 
| VISA XX-8488 


New card 


PAY NOW 


Cancel 





URE Skrill 


Symantec 


Figure 3-1: Initial Skrill Wallet page 


Select a card, enter the CVV number, then click Pay Now to process the payment. Customers can also 
add then pay with a new card using the + New card button. 
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Alternatively, customers can choose to pay with their Skrill Balance. They can click the Skrill Balance 
tab to display the following screen: 


Welcome | Logout 


1.00QEur o AMME 





— Skrill & 


== Balance Poy now. 


BALANCE 


48.89 


(67.89 EUR) 


PAY NOW 


Cancel 


SEE Skrill 


Symantec 


Figure 3-2: Pay using Skrill Balance 


The customer can now review the payment details and click Pay Now to complete the payment. If the 
customer does not have a sufficient balance, the Skrill Balance will be greyed out, the Pay Now option 
will not show, and an insufficient funds message will be displayed. 
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3.2. Customers who want to register for a Skrill account 


New customers do not need to register for a Skrill account, but if they want they can click the Pay by 
Skrill tab or button and select the Sign Up link (see Pay by Skrill tab on page 2-21). Customer login or 
sign up is mandatory for certain Skrill payment options, such as Skrill 1-Tap and Recurring Billing. 
Selecting Sign Up will display the following screen: 


& English 


Skrill account sign up 


Name 
Skrill Techpubs 


Country of residence 


United Kingdom z 


Address line 1 
11 Payer St 


Address line 2 (optional) 


Postcode City 
London 


Date Of Birth 
13 12 1972 


Email address 


techpubs@skrill.com 


Password 


U | agree to Terms of Use and Privacy Policy, am 
aware that | may receive communications from Skrill 
and understand that | can change my communication 
preferences at any time. 


CREATE ACCOUNT 


Gips Skrill 


Figure 3-3: Create Skrill account (long version of the form) 
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The customer can now enter their personal details including date of birth, email address, and 
password and click Create Account. All the parameters provided by the merchant website are 
prefilled. The rest of the process is the same as that detailed in Existing customers accessing their 
Skrill Wallet account on page 3-1. 


If the merchant website provides the address, country, postcode, and city parameters, a short version 
of the sign-up form is used instead: 


English 


Skrill account sign up 


Name 
Skrill Techpubs 


Date Of Birth 
13 12 1972 


Email address 


techpubs@skrill.com 


Password 


U | agree to Terms of Use and Privacy Policy, am 
aware that | may receive communications from Skrill 
and understand that | can change my communication 
preferences at any time. 


CREATE ACCOUNT 


Gips Skrill 


Figure 3-4: Create Skrill account (short version of the form) 
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You can customize the Skrill Quick Checkout page in the following ways: 


e Pre-populating payment fields 


e Displaying payment and order details 


e Preselecting or displaying payment methods 


e Displaying specific credit/debit card brands 


e Straight Through Redirect 


e Displaying your company logo or brand 


e Embedding the Quick Checkout page 


e Removing or reducing the header and reducing the footer 


e Recurring billing 


4.1. Pre-populating payment fields 


To speed up the payment process for the customer, you can supply the following parameters with 


each transaction: 


Table 4-1: Parameters to pre-populate payment fields 





Field name 


Description 


Max length 


Example value 





pay_from_email 


Email address of the customer who is making 
the payment. If provided, this field is pre- 
populated (or pre-populated and hidden) as 
appropriate, on the payment form. It will be 
pre-populated and hidden for the following 
payment methods: 

WCO, POLi, credit/debit card payment, and 
ePay. 

If this field is omitted or left empty, the 
customer has to enter their email address. 


100 


payer@skrill.com 





firstname 


First name of the customer. This value will be 
prefilled if the Merchant submits it via the 
‘firstname’ parameter 


20 


John 





lastname 








Last name of the customer. This value will be 
prefilled if the Merchant submits it via the 
‘lastname’ parameter 





50 





Payer 








© Skrill 2021 


4-1 


Skrill Quick Checkout Integration Guide 8.1 


The following figure shows an example of the Quick Checkout page. 


SELECT LANGUAGE 





Eb English 


5.00 Eur de A ACME 


(Œp) 09: ween S 


2 E S S&S va 


Card number 





Expiry date Security code 
Name on card 
NAME FIELDS ARE John Payer 
PREFILLED 
PAY NOW 


Cancel 


Y Norton Powered by 


E Skrill 


Figure 4-1: Skrill page with pre-populated fields 


Note: You can include additional parameters, such as the customer's address, city, country, language, 
postal code, and date of birth. If the customer selects the sign-up link to open a new Skrill 
Digital Wallet account, these fields will be prefilled on the registration form. If they are all 


prefilled (address, city, country, and postal code), they will be hidden to simplify the sign-up 
form. See Chapter 3: Skrill Digital Wallet Payments for more details. 
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4.2. Displaying payment and order details 


Your payment request can include your own itemised payment details, such as an order description 
and amount breakdown. The customer can view these payment details by selecting the information 
icon displayed next to the amount and currency. 


® English 


CUSTOMER SELECTS TO 


25 q 00 EUR | VIEW PAYMENT DETAILS 


Figure 4-2: Top of payment form shows total amount 


Click the icon to display the Payment details overlay screen. 


x 
Payment details | 
Item code: XYZ1234 
CUSTOMER SEES THE ORDER 
DETAILS YOU INCLUDED IN Item code: ABC1234 
YOUR REQUEST 
Total: 15.00 
lax: 5.00 
Shipping: 5.00 
Total 25.00 EUR 





Close 





Figure 4-3: Payment details screen 


You can include up to five additional description fields and three amount fields (see Payment details 
in Table 2-1 on page 2-5). For an example of HTML form, which implements these fields, see Example 
HTML forms on page 8-7. 
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4.3. Preselecting or displaying payment methods 


Which payment methods are displayed depends on the configuration setting for your merchant 
account; there are two options: Fixed or Flexible (also known as Fixed Split Gateway or Flexible Split 
Gateway). This feature is set up for your account by Skrill. For details, please contact Skrill Merchant 
Services. 


The Fixed option is used to specify the payment methods to display to customers in the Quick 
Checkout payment form (if these payment methods are available in the customer's country). For 
example, you can display only Paysafecard, Klarna, and Rapid Transfer on the payment form instead 
of the generic Skrill options for the customer’s country. These methods will appear in the Payment 
method tabs where their logos will be displayed. For a list of currently supported alternative payment 
methods and their codes, see Payment method codes on page 8-9. 


& English 


39.60cur A ACME 


—| ` CLICK TO VIEW 
AVAILABLE PAYMENT Peng 
| commen Bpoysole y 
METHODS BASED ON T =D | RAPID. Poy ADDITIONAL 
SELECTED COUNTRY PAYMENT 
OPTIONS 


wa GS CO Æ E 


Figure 4-4: Payment method tabs 


The Flexible option is used to preselect a payment method and display it in the first payment method 
tab (if this payment method is available in the customer’s country). The other payment methods 
available in this country are displayed in the other tabs. 


Note: The customer’s country is determined by the country parameter passed to the Skrill Payment 
platform. If no country parameter is provided, Geolocation is used instead. 
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To use either option, the following parameter must be included in your payment request: 


Table 4-2: Parameters to include when specifying the payment method 








SE Max Example 
Parameter Description length value 
payment_methods This parameter has a different effect depending on the 100 VSA,WLT, 
configuration of your Skrill merchant account (fixed or PSC 
flexible). 
For the flexible option, only a single payment method 
code is used. 


For the fixed option, you can supply one or more 
Payment method codes separated by commas. 

Note: If you do not provide a value all the payment 
methods available in the customer's country are 
displayed. 

For a full list of codes, see Payment method codes on 
page 8-9. 

















Note: Before implementing this option, you should also confirm which payment methods are 
available for your account. Restrictions apply for merchants who are based outside of Skrill's 
standard region (USA and Europe). For details, see Quick Checkout for out-of-region 
merchants on page 2-22. 


4.3.1. Fixed payment methods 

With the Fixed payment option, when you submit a payment method using a single 

payment methods parameter, only that payment method is shown to the customer on the payment 
form. Ifthe payment method is not supported by the customer's country, the form shows all other 
available payment methods for this country. If you provide more than one payment method code 
separated by commas, the first payment method listed is preselected and shown in the first tab. The 
subsequent payment methods are then shown by order of their popularity in the customer's country. 
Note that this is used instead of the order they are listed in the payment methods parameter. 


If a single payment code is used and this payment method is not available in the customer's country, 
the full list of available payment methods is presented to the customer. For example, ifiDEAL was 
chosen, but the customer is not a Dutch resident. If multiple payment method codes are used, any 
unavailable payment methods are ignored. The following example shows the fixed payment method 
option with a single code: 





<input type="hidden" name="payment methods" value="ACC"> 
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Welcome Warren Singer | Logout 


bh Oe 0 A AME 


ONLY CARDS TAB IS 
SHOWN 





Skrill ¡=> Sall y O 


ms : 
Balance Direct 


(pu Skrill 


Figure 4-5: Fixed payment methods - Cards only 


4.3.1.1. Displaying specific credit/debit card brands 


By default, all card brands are displayed on Quick Checkout. You can override the default behaviour, 
by specifying the card brand you want to display on the payment form. This option only works with 
the Fixed payment method option. Use the ACC payment method code to display all available card 
brands. Only one card payment tab is permitted. See the example below. 


<input type="hidden" name="payment methods" value="VSA"> 
D = 
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& English 


15.00 ur © AMME 


=] © 


ONLY VISA BRAND IS SHOWN isa 


Card number 


Expiry date Security code 


Cardholder name 


Sample Payer 
Email address Why? 
PAY NOW 
Cancel 
(Y Norton Powered by 
dc Skrill 


Figure 4-6: Visa-only brand 


Note: Restrictions apply for merchants who are based outside of Skrill’ s standard region (USA and 
Europe). For details, see Quick Checkout for out-of-region merchants on page 2-22. 


When the customer selects the Credit/Debit Card payment tab and enters their card number in the 
Card number field, the card type is automatically validated and the card logo is displayed, as shown in 
the example below. 


E) MAPD omm o 


visa SS 912.2 N 


Card number 
| 4462 VISA ajos LOGO IS SHOWN 








Figure 4-7: Card logo displayed next to the card number 
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4.3.1.2. Straight Through Redirect 


Straight Through Redirect is used with a single payment method code to automatically redirect 
customers to the Payment Method provider's website without showing the Quick Checkout payment 
form. Once redirected, the customer provides their name and any other details required and then 
confirms the payment. Straight Through Redirect reduces the number of steps to complete the 
payment. 


This option is only available if the following conditions apply: 


e Your merchant account is set to use Fixed payment methods 
e You pass a single payment method code in the payment methods parameter 


e You provide a customer email address using the pay from email parameter. If no email 
address is provided, the Quick Checkout payment form will display to allow the customer to 
enter their email address. The customer will then need to click Proceed to <Payment 
Method> to continue. For example: Proceed to ALIPAY. 


The following table lists the payment methods which support Straight Through Redirect: 


Table 4-3: Payment methods which support Straight Through Redirect 


























Payment method Method code 
AliPay ALI 
Przelewy24 PWY 

Trustly GLU 
Paysafecard PSC 
Paysafecash PCH 

Neteller * (See Note below) NTL 

Klarna SET 














Note: * The process for the Neteller payment method is slightly different. The first two conditions 
above apply as normal. You must also provide a neteller secure id containing the Secure ID or 
Google Authenticator One-Time Password for the customer's Neteller account and the Neteller 
customer account email or account ID in the neteller account parameter. However, you do not 
need to provide a customer email address in the pay from email parameter if you use the 
Neteller customer's email address in neteller account. If you provide email addresses in both 
parameters, neteller account overrides pay from email. 
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4.3.2. Flexible payment methods 

With the Flexible payment option, when you submit a payment method using the payment methods 
parameter, that method is preselected for the customer. All other payment methods enabled for 
your account and for the customers” country are shown in the other payment tabs. If the chosen 
payment method is not supported in the customer's country, the payment tabs show all other 
available payment methods for this country, listed by popularity. 


See the example below. 


<input type="hidden" name="payment methods" value="OBT"> 





& English 


39.60 ur © A AME 


RAPID TRANSFER (OBT) 


d aa] Payby 
IMA E) Ba mes O 


Bank transfers with Rapid Transfer are 
confirmed instantly Your payment can be 
processed immediately using your online bank 
credentials 


Bank/Sort code 
Account number 
Account holder name 


John Payer 


Email address Why? 


You will be redirected to Rapid Transfer to complete this 


payment 
Norton Powered by 
Y Skrill 


Figure 4-8: Flexible payment methods - OBT preselected 
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4.4. Integrating Quick Checkout into your website 


These options enable you to customize the appearance of the Skrill Quick Checkout page, by either 
adding your own logo/brand or embedding the page in your website. 


4.4.1. Displaying your company logo or brand 

You can display your company logo on Quick Checkout. To do this your payment request should 
include the logo parameter, with a secure HTTPS link to the logo on your website. See the example 
below. 


<input type="hidden" name="logo" value="https://www.skrill.com/fileadmin/content/ 
pdf/acme.png"> 


English 
YOUR LOGO APPEARS 


HERE AND IS 
3 9 6 8 EUR & AUTOMATICALLY 
i RESIZED TO FIT 
pen 7 
=p) Ga o 


visa 65 ES 


Card number 
4462-0012-3456-7890 VISA 





2 EE 


Expiry date Secunty code 
41 || 19 134 = 


Cardholder name 
John Payer 


Email address Why? 





| techpubs@skrill.com | 


PAY NOW 


o= Skcill 





Figure 4-9: Skrill Quick Checkout with merchant logo 
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4.4.2. Embedding the Quick Checkout page 
You can embed the Quick Checkout page in your website using an iframe. You can define in which 


frameset the return url and cancel url pages should be opened upon a successful payment or 
cancellation by the customer. 


Note: If you are embedding Quick Checkout in your website, you can request a version of Quick 
Checkout which has the header removed and the footer reduced in size, enabling a more 
seamless and integrated appearance on your website. For details, see Removing or reducing 
the header and reducing the footer on page 4-13. 


Below is an example of the Quick Checkout page displayed in an iframe. 
Merchant Website Header area 


Return to main website => RAPID. P 8. | 


Contact us 


vsa GE CƏ vz 2 a 








f xpiry date Security de | 
= 746 aes 


Cardholder name 


John Payer 


Email address 


Merchant Website Footer area 


é corro 432 pixels AE 


Figure 4-10: Display the Quick Checkout page in an iframe 
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To prevent scroll bars appearing, the minimum sizes of the iframe for card payment is: 


e 400px horizontally by 530px vertically - reduced header and footer option 


e 400px horizontally by 550px vertically - reduced header option 


The iframe option is implemented by submitting two additional parameters in your HTML form: 


Table 4-4: Parameters submitted when using an iframe 











Field Name Description Values Vax Default Example 
length 
return_url_target Specifies a target in which the 1='_top' 1 1 3 
return_url value will be called ='_parent' 
upon successful payment from 3=' self 
customer. 4='" blank 
cancel url target Specifies a target in which the =' top' 1 1 3 
cancel url value will be called =" parent' 
upon cancellation of payment 3=' self 
from customer. 4='" blank 























These values have the following results: 


Table 4-5: iframe targets 

















Value Equivalent Description 

1 ' top Opens the target URL in the full body of the window - the URL contents fills the 
entire browser window. 

2 '_ parent' Opens the target URL in the parent frame. 

3 '_self' Opens the target URL in the same frame as the payment form. 

4 '_blank' Opens the target URL in a new browser window. 














Note: The iframe option works well with card and SEPA payments. However, it may not be suitable if 
you are offering any alternative payments methods through Skrill, which typically redirect to 
third party websites of varying sizes. 
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4.4.3. Removing or reducing the header and reducing the footer 

You can request a version of the Quick Checkout page without the Skrill header and amount fields. 
The security logo is also removed from the footer, to reduce its size. You can enable this option at any 
time by contacting Skrill Merchant Services. However, we recommend that you request this feature 
when integrating to ensure a good UI experience. 


See the example below. 


CUSTOMER SHOPPING CART SKRILL QUICK CHECKOUT PAGE WITH 
ORDER SUMMARY —_— HEADER AND FOOTER TRUNCATED 
3. Payment 


Order Summary. 


— a: é 
BILLING ADOMESS: EDIT DEL "WERT ADOKESS: EDT 3] Skrill 
e us e P 2 en = 
Card number 
ew 
Expiry date Security code 


Name on card 


Email address 
£14,99 


Skrill 


Figure 4-11: Reduced header and footer Quick Checkout page, embedded on a merchant's website 
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You can also reduce the size of the header by removing the payment details and merchant logo but 
leaving the language selector and footer unchanged as shown below: 


& English 


Skill =D) MAIA ce O 





visa GS CD 2 

Card number 

Expiry date Security code 
Cardholder name 

John Payer 

Email address Why? 


Norton Powered by 
g Skrill 
Figure 4-12: Reduced header Quick Checkout page 


4.4.4. Recurring billing 


Skrill Quick Checkout enables merchants to receive recurring credit card and direct debit payments 
from customers without a Skrill Wallet registration. 


In addition to the standard HTML form parameters, you can supply the following parameters to set 
up recurring payments: 


Table 4-6: Recurring payment parameters 





























Field name Description Required | Max. length | Example value 
rec_amount Amount of the recurring payment | Yes 19 19.90 
(to be taken at each recurring 
period) 
rec_start_date* | Start date of the period in DD/ No 10 01/01/2018 
MM/YYYY format 
rec_end_date Final date of the period in DD/ No 10 31/03/2018 
MM/YYYY format 
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Table 4-6: Recurring payment parameters (Continued) 

















notifies you that the recurring 
payment is canceled. 











Field name Description Required | Max. length | Example value 
rec period Number of rec cycles between Yes 14 (without a rec cycle 
payments defined this results in 14 
days between payments) 
rec cycle The time period e.g., day/month/ | No day 
year. If this parameter is not 
submitted, Skrill assumes that the 
rec cycle is days. 
rec status url URL to which Skrill notifies you No 400 http:// 
that the recurring payment is www.example.com/ 
canceled rec_pay_cancelled.htm 
rec_status_url2 | Second URL to which Skrill No 400 http:// 





www.example.com/ 
rec_pay_cancelled2.htm 











Note: * Future start dates are not allowed unless accompanied by a third-party deposit (amount). 


Example code 




















<input type="hidden" name="rec amount" value="19.90"> 

<input type="hidden" name="rec start date" value="01/02/2018"> 

<input type="hidden" name="rec end date" value="31/01/2020"> 

ate NE ype Uhr ddent name las periost yal Hs 

Sinput type hidden name=-Vrec eyelet valve='monthi> 

<input type="hidden" name="rec status url" value="http://www.example.com/ 
ree pay Cancel ola > 








<input type="hidden" name="rec status url2" value="http://www.example.com/ 





rec pay cancel2.htm"> 


Supported recurring payment types 


You can set up the following types of recurring payments: 


Table 4-7: Recurring payment types 





Payment type Description 


Example 





Pay third-party deposit Normal third-party deposit is available 


Pay now = $3.00 








Third-party deposit + Recurring payment starting now, Pay now = $3.00 + Rec Pay ($2.00 
initial recurring now accompanied by a third-party deposit every x days; start: today; end = 
ddmmyyy) 
Third-party deposit + Recurring payment starting in the Pay now = $3.00 + Rec Pay ($2.00 
initial recurring future future, accompanied by a third-party every x days; start: future; end = 
deposit ddmmyyyy) 





No third-party deposit+ | Recurring payment starting now, 
initial recurring now without a third-party deposit 











Rec Pay ($2.00 every x days; start: 
today; end = ddmmyyyy) 
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Payment methods used with recurring billing 

A recurring billing payment can be set up with one of the following payment methods: 
e Credit/debit card (Visa and Mastercard) 
e Direct Debit 


Recurring billing status 


If a recurring billing has been set up and you have provided a rec status urlin your HTML form, Skrill 
posts the transaction details of each payment to your rec status url page. The following table shows 
the parameters to be received on your page: 


Table 4-8: Recurring payment billing parameters 











Field name Description Required | Example value 
merchant id Unique ID of your Skrill account. ONLY Yes 100005 
needed for the calculation of the MD5 
signature 
transaction_id The reference or identification number Yes A205220 


you provided 




















status Recurring payment status: 2 processed/ | Yes 2 
-2 failed 

rec_payment_id Recurring payment ID Yes 200005 

rec_payment_type | Type of payment: ‘QCO’ Yes recurring 

mdb5sig MDS signature Yes 327638C253A4637199CEBA6 
642371F20 

sha2sig SHA2 signature No dbb7101322257a311f08d1c5 
27053058fc7e464e30bcfb461 
3f09053c22dd1f8 

merchant_fields A comma-separated list of field names No Field1, Field2 


that are passed back to your status page 
when the payment is confirmed 




















Using the Merchant Query Interface 


You can use the Merchant Query Interface to check the status, cancel, or extend the end date of a 
recurring payment. For details, see the Automated Payments and Merchant Query Interfaces Guide. 
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5. ACCOUNT AND INTEGRATION OPTIONS 


You can use the following account and integration options: 


e Secure return url parameter 
e Merchant refunds 
e Chargeback notification 


e Adding a descriptor 


Note: Code integration examples on page 5-3 describes how to generate a session identifier and 
redirect the customer to Skrill. 


5.1. Secure return_url parameter 


A secure return url parameter allows you to be certain that the customer has arrived at your 
return_url page by completing the payment process, rather than by looking up the return_url value in 
the page source code and entering it into their browser. However, this function only guarantees that 
the customer has completed the payment process, not that the payment had been processed. 


If this feature is not activated, please contact Skrill Merchant Services. 
You must submit the following parameters with each transaction: 


e return url 
e transaction id 


e secret word (this will be automatically submitted if entered in the Settings > Developer 
Settings section in your Skrill account). 


Skrill will then add the following parameters to the return url: 


Table 5-1: Parameters returned with the return URL 











Parameter Description Example value 
transaction id | The transaction id you submitted. A205220 
msid The MDS signature, with the following values: 730743ed4ef7ec631155f5e 


e merchant id, for example: 123456 15d2f4fa0 


e  transaction_id, for example: A205220 


e upper-case MD5 value of the ASCII 
equivalent of your secret word, for 
example: 
F76538E261E8009140AF89E001341F17 














The following are two examples of the secure return_url, using the values above. 
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Example 1 

Merchant submits return url without additional parameters. For example: 
https://example.com/return url.cgi 

In this case Skrill will redirect the customer to: 

https://example.com 


return url.cgi?transaction id=A2052208msid=730743ed4ef7ec631155f5e15d2f4fa0 


Example 2 


Merchant submits the return url with additional parameters. For example: 


https://example.com/return url.cgi?parl=vall&par2=val2 


In this case Skrill will redirect the customer to: 





5.2. Merchant refunds 


This option enables you to refund a payment to the customer’s Skrill account, credit/debit card or 
bank account (depending on the original payment method used). If this feature is not activated, 


please contact merchantservices@skrill.com. 


Note: If your account is configured to allow refunds, you will have an additional action link in the 
transaction history next to each entry that will trigger a refund to the customer. 


You can also make refunds through Skrill’s Automated Payments Interface (API). For details, see the 
Automated Payments and Merchant Query Interfaces Guide. 


5.3. Chargeback notification 


When Skrill receives a chargeback request from the provider, a chargeback notification is sent to your 
status_url page and an email is sent to the primary email address linked to your merchant Skrill 
account. The status code sent to the status url page is -3. (For a description of transaction status 
values, see Transaction status on page 2-19.) 


5.4. Adding a descriptor 


When a customer pays through Skrill, Skrill submits a descriptor with the transaction, containing your 
business trading/brand name. The descriptor is typically displayed on the bank or credit card 
statement of the customer. If you want to change this descriptor, please contact 
merchantservices@skrill.com. This functionality is only available for the following payment methods: 


e Visa 

e Mastercard 
e Klarna 

e Direct Debit 
e iDEAL 
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Note: This feature is not available for cards from out-of-region banks. 


For Klarna and Direct Debit, you can also submit an additional payment form parameter, 
dynamic descriptor, which will override the default value stored by Skrill. 


5.5. Code integration examples 


You can use the examples below to generate your session ID from Skrill, which is the recommended 
method for connecting to Quick Checkout, as described in Secure redirection method on page 2-4. 


5.5.1. Generating the Session Identifier 


Below are examples of how to generate a SID using different programming methods. 


cURL 


cuil =x LOST EE / 7 pay Skrill coja 


-d "pay to email=merchant emailfimail.com" 


-d "amount=10.99" 
-d "currency=EUR" 
-d "language=EN" 
zl prepare amiy=14 


Ruby 





require 'net/http' 
require 'net/https' 


require 'uri' 


uri = URI('https://pay.skrill.com') 


http = Net: :HTT 
heto use ssl = 
Pec = News gUn? 
reg.set form da 





'pay to email'=>'merchant emailfmail.com', 


"amount '=>'10. 
"currency'=>'E 





P.new(uri.host, uri.port) 
true 
::Post.new(uri.path) 


ta({ 


99% 
UR 





"language '=>'EN', 


Posepasemoniliva: 


}) 


=>'1' 


res = http.request (reg) 


puts res.body 


5.5.2. Redirecting the customer to Skrill 


Once you have the session identifier (SID), you have to redirect the customer to Skrill, and include the 


session identifier. 


https://pay.skrill.com?/sid=<generated_sid> 


Where <generated_sid> is the SID returned by Skrill. 


You can open the URL with the SID as a light box or in an iframe. 
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6. SKRILL 1-TAP PAYMENT 


Skrill offers a single-click payment service which enables you to automatically debit transactions from 
your customer's Skrill account without the customer having to authorise the payment each time. 


Customers are sent an email notification after each 1-Tap payment and they can view the status of all 
their Skrill 1-Tap payments in the History section of their Skrill Wallet account. 


Customers can pay using Skrill 1-Tap with any of the following payment methods linked to their Skrill 
account: 


e Credit/debit card (Visa and Mastercard) 
e Direct Debit 


6.1. Enabling 1-Tap 


To enable this service, contact Skrill Merchant Services. 


Note: You must set up a separate merchant account for taking Skrill 1-Tap payments. 


6.2. Enable the MQI and API 


You will need to enable the MQI (merchant query interface) and API (automated payment interface) 
and set up an MQI/API password to use 1-Tap. You can also change the MQI/API password here in 
this section. 


To enable the MQI and/or API: 


1. Log into your Skrill account at www.skrill.com. 
2. Goto Settings > Developer Settings > API / MAI / GSR / CVT Management. 


3. Set the API / MQI Password, and click Save to confirm. 


4. Specify at least one IP address from which requests will be made. All requests from other IP 
addresses are denied. Access can be granted to: 


e Asingle IP address (e.g. 192.168.0.2) 
e Multiple IP addresses, separated by a space (e.g. 192.168.0.2 10.0.0.2) 
e Asubnet in CIDR notation (e.g. 175.10.10.252/30). 


Warning: CIDR ranges should be no longer than 256 IP addresses. 


Note: If the Settings > Developer Settings section is not displayed in your account, contact Skrill 
Merchant Services. 


5. To apply your changes, click Save. 
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Set API / MQI Password Enabled 


Figure 6-1: Enable the API and MQI and set up a password and IP range for these services 


You must use a separate password for API or MQI requests. This ensures that the password you use to 
access your Skrill Digital Wallet account can be changed without affecting the API or MQI. 


Note: The password must be at least 8 characters long and must contain at least one alphabetic and 


one non-alphabetic character. 


The MAI is used for the following functions: 


Repost transaction status information for payment transactions (Wallet Checkout, Quick 
Checkout, and 1-Tap subsequent payments) 


View transaction status (payment and send money transactions) 
View account history 

Cancel a recurring payment 

View the status of a recurring payment 

Extend the end date of a recurring payment 

Cancel a 1-Tap payment 


View the status of a 1-Tap payment 


The API is used for the following functions: 


Refund Quick Checkout, Wallet Checkout, or 1-Tap payments (Note: This functionality is not 
available for Gambling and FOREX Merchants) 


Transfer money to another Skrill Account 


Take subsequent 1-Tap payments after the initial setup payment 
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6.3. Skrill 1-Tap button 


The Skrill 1-Tap button must be displayed on your website when setting up Skrill 1-Tap mandates and 
with any subsequent transactions performed through Skrill 1-Tap. 


Skrill 1-Tap™ | 


Figure 6-2: Skrill 1-Tap button 





This button is available in different sizes. For details, see: 


https://www.skrill.com/en/business/merchants/brand-centre 


6.4. Call flows 


Initial payment request 


The following figure provides an overview of the 1-Tap payment setup process. 


a de 





Merchant 


| i À 


Customer 





v= Skriti 


Figure 6-3: Initial Skrill 1-Tap payment flow 


1. When the customer is ready to pay for goods or services on your website, they select the 
payment button on your website. 


2. You request a session identifier (SID) by passing customer and transaction details (e.g., 
amount, currency, and language) to the Skrill Quick Checkout. You also include the required 
1-Tap parameters. 


3. Skrill returns the generated SID. 


4. Using a light box or iframe you redirect the customer to the Skrill Quick Checkout and include 
the session identifier in the redirect URL. Skrill displays the payment page. 


5. The customer pays using the preferred payment method and confirms the transaction. 
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6. Skrill requests authorisation for the payment from the customer’s bank, third party provider, 
or card issuer. 


7. The bank/provider approves or rejects the transaction. 


8. Skrill displays the confirmation page, containing the transaction result, on the Skrill Quick 
Checkout. 


9. Skrill provides you with an asynchronous notification, sent to your status URL or IPN (instant 
Payment Notification), confirming the transaction details and status. These details include 
the rec payment id of the 1-Tap payment, which can be used for future 1-Tap debits from 
the customer's account. 


Note: You should keep track of the status of 1-Tap payment and update your records if notified of a 
status change at the ondemand status url you submitted for the 1-Tap payment. 


Subsequent payments 


The following figure provides an overview of the 1-Tap payment process after the initial setup is 


complete. 
ds ` e 
Em, 
H 
A- — 


Merchant 


dk o 


Customer 





q 


Skriti 


Figure 6-4: Subsequent Skrill 1-Tap payment flow 


1. The customer clicks the Skrill 1-Tap button. 
2. The merchant checks the status of the 1-Tap mandate using their records or the Merchant 
Query Interface (MQI). 


3. Ifthe customer is already set up for 1-Tap, the merchant makes the prepare request. Both 
frn_trn_id and rec_payment_id should be provided. 


Note: If the customer is not set up for 1-Tap, then the merchant makes a normal Quick Checkout 
payment request and optionally submits 1-Tap payment details to set up the 1-Tap service, as 
described previously in Initial Skrill 1-Tap payment flow on page 6-3. 
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or card issuer (if required). 


The Skrill 1-Tap Payment Interface validates the request. 


8. The bank/provider approves or rejects the transaction. 


The Skrill 1-Tap Payment Interface returns the session identifier (SID). 


The merchant sends the execution request with the returned SID. 


Skrill requests authorisation for the payment from the customer's bank, third party provider, 


9. The Skrill 1-Tap Payment interface sends a response with the transaction status. 


10. The transaction status notification is also posted to the merchant's status URL. 


11. The merchant notifies the customer of the status of the 1-Tap payment. 


6.5. Setting up an initial 1-Tap payment 


In addition to the standard parameters described in Skrill Quick Checkout parameters on page 2-5, 
you can supply the following parameters to set up a Skrill 1-Tap payment via the Skrill Wallet 


Checkout: 


Table 6-1: Skrill 1-Tap parameters 


























that the Skrill 1-Tap payment is 
cancelled. 

This URL is restricted to the same 
ports as the status_url 











A e E Max 
Field name Description Required length Example value 
ondemand max amount Maximum amount for future Yes 9 11.50 
payments that will be debited 
from the customer's account 
ondemand max currency | 3-letter code of the currency of Yes/No 3 EUR 
the maximum amount according 
to ISO 4217 (see ISO 4217 
currencies on page 8-1) 
ondemand note Text shown to the customer in Yes 1000 credit topped up 
the payment confirmation email 
as the reason for the Skrill 1-Tap 
payment. 
ondemand status url URL to which Skrill notifies you No 400 http:// 
that the Skrill 1-Tap payment is www.example.com/ 
cancelled. od_payment_cancel 
This URL is restricted to the same led.htm 
ports as the status url 
ondemand status ur? URL to which Skrill notifies you No 400 http:// 


www.example.com/ 
od payment cancel 
led2.htm 





Notes: 


e If“ondemand max currency' is not provided, the currency value will be the one provided as the 
‘currency’ in the standard HTML form (see Skrill Quick Checkout parameters on page 2-5). 


e A session identifier (SID) parameter is returned upon success. 
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The Skrill response includes a rec payment id. You should store the rec payment id field so that you 
can reference the original 1-Tap transaction. 


You can track the status of any 1-Tap transaction and perform refunds using your own unique 
transaction id for that transaction. 


Example of a Skrill 1-Tap payment form 


See the example below. The included 1-Tap payment fields are highlighted. 










































































<form action="https://pay.skrill.com" method="post" target="_blank"> 
<input type="hidden" name="pay to email" value="demowallet@sun-fish.com"> 
<input type="hidden" name="status url" value="https://www.example.com/status"> 
<input type="hidden" name="language" value="EN"> 
<input type="hidden" name="amount" value="39.60"> 
<input type="hidden" name="currency" value="GBP"> 
cenpucitiyoesUhiddeniname dera lil lee bereet) valve lee ee ere 
<input type="hidden" name="detaill text" value="Romeo and Juliet"> 
<input type="hidden" name="recipient description" value="ACME Solutions"> 
<input type="hidden" name="ondemand max amount" value="150.00"> 
<input type="hidden" name="ondemand max currency" value="EUR"> 
<input type="hidden" name="ondemand note" value="Your 1-Tap Payment"> 
<input type="hidden" name="ondemand status url" 
value="www.example.com/ondemandstatus1"> 
<input type="hidden" name="ondemand status url2" 
value="www.example.com/ondemandstatus2"> 
<input type="submit" value="Pay!"> 
</form> 
6.6. Taking subsequent 1-Tap payments 


Oncea 


Skrill 1-Tap payment has been set up, you must use the Skrill 1-Tap Payment Interface (part of 


Skrill’s Automated Payment Interface) to make individual requests to debit the customer’s Skrill 


accoun 
details 


Conne 


t. If you have provided a status url value in your HTML form, Skrill will post the transaction 
of each payment to that URL. 


cting to the 1-Tap interface 


You can connect to the Skrill 1-Tap interface by sending HTTPS GET/POST requests to: 


https://www.skrill.com/app/ondemand_request.pl 


Notes: 


Taking 


1. 
2. 


You must enable the Skrill Automated Payment Interface (API) and setup an MQI/API 
password 


Skrill recommend using POST for maximum security. 
Do not mix GET and POST requests. Choose which method to use and apply consistently. 
POST parameters are encoded using Content-Type: application/x-www-form-urlencoded 


GET parameters are encoded in the URI query string using & delimiters (e.g. GET parameters 
are sent as part of the URL query string https://www.skrill.com/app/query.pl?action=status 
_trn&email=mb654 @abv.bg&password=53903d217504eb37f3fdb0ce77610558&mb_trn_id 
=104627261) 


subsequent 1-Tap Payments is a two-step process: 


Send a first request with action set to prepare to receive a session ID for step 2 


Send a second request with action set to request using the session ID from step 1 to execute 
the payment. 
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These steps are described in more detail below. 


6.6.1. Prepare payment step 


Action parameter: action=prepare 


This action prepares the transaction that will be executed later using the request action. The 
following parameters are required: 


Table 6-2: Parameters to include with the prepare request 












































containing your own unique parameters. 








Field name Description Required | Example value 
email The email address linked to your Skrill Yes info@example.com 
account 
password The lowercase hex MD5 of your API/MQI Yes 9f535b6ae672f627e 
password 4e5f79f2b7c63fe 
action The required action Yes prepare 
amount The amount of the request for a debit Yes 10.50 
transaction 
currency 3-letter code of the currency you wish to Yes EUR 
debit according to ISO 4217 
ondemand_note Text shown to the customer in the No Credit topped up 
payment confirmation email as the reason 
for the Skrill 1-Tap payment 
frn_trn_id Your transaction ID, used for the payment. | Yes A205220 
This is your own unique reference for this 
transaction 
rec_payment_id Recurring payment ID (rec_payment_id Yes 200005 
value) sent to your status_url page when 
you created the Skrill 1-Tap payment 
merchant_fields A comma-separated list of field names that | No Field1, Field2 
are passed back to your Web server when 
the Skrill 1-Tap payment is confirmed 
(maximum 5 fields) 
Field1 An additional field you can include, No Valuel 
containing your own unique parameters. 
Field2 An additional field you can include, No Value2 
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Notes: 


e Bothfrn ren idandrec payment id should be provided. You should use the rec payment id field to 
reference the original 1-Tap transaction and provide a unique frn trn id as the reference for the 
current transaction. 


e Ifondemand note is not provided, the one that is submitted when creating the Skrill 1-Tap payment 
will be used. 


e A session identifier (SID) parameter is returned upon success. 


You can track the status of any 1-Tap transaction and perform refunds using the unique frn trn idfor 
that transaction. 


Skrill response 


Skrill returns an XML response to your prepare request which contains a <response> tag with one of 
the following elements: 


e sid element - returned if the authorisation and payment preparation is successful. The SID 
(session identifier) must be submitted in your transfer execution request. 


e error element - included if an error occurs. It includes an <error msg> tag, which contains the 
error message description. 
Example 1: Successful prepare request 


Below is an example of a successful prepare request. 


Request 
POST https://www.skrill.com/app/ondemand_request.pl 


Header 
Content-Type: application/x-www-form-urlencoded 


Body 


mail=sample.merchant%40sun- 
fish.com&password=fb0dc09bd0989fe97 5afd3e4ddabb926é&action=prepareéamount=1.23&curre 
ncy=EUR&ondemand_note=ondemand+note&frn_ trn_id=12341990&rec payment id=1668618647 














Response 

<?xml version="1.0" encoding="UTF-8"?> 

<response> 
<sid>4414c2a969c744c27bd674a0b0a5ba8a</sid> 

</response> 
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Example 2: Failed prepare request 


This example shows a request that failed, due to an invalid merchant email. 


Request 


POST https://www.skrill.com/app/ondemand_request.pl 


Header 


Content-Type: application/x-www-form-urlencoded 


Body 


email=&password=fb0dc09bd0989fe975afd3e4ddabb926&action=prepare&gamount=1.234currenc 


y=EUReondemand note=ondemand+notesfrn trn id=12341990grec payment id=1668618647 





Response 





<?xml version="1.0" encoding="UTF-8"?> 





KE 
<serror> 


<error msg>LOGIN INVALID</error msg> 


K/error> 
</response> 


Table 6-3: General errors 





Error 


Description 





SESSION_EXPIRED 








The session has expired. Session IDs are only valid for 15 minutes. 








Table 6-4: Errors when making Skrill 1-Tap payment requests 





Error 


Description 





CUSTOMER IS LOCKED 


The customer's account is locked for outgoing payments 





BALANCE NOT ENOUGH 


The customer's account balance is insufficient 





RECIPIENT LIMIT EXCEEDED 


The customer's account limits are insufficient 





CARD FAILED 


The customer's credit or debit card failed 





REQUEST FAILED 


A generic response for the transaction failing for any other reason 





ONDEMAND CANCELLED 








The customer has cancelled this Skrill 1-Tap payment 
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Table 6-4: Errors when making Skrill 1-Tap payment requests (Continued) 











Error Description 
ONDEMAND INVALID The Skrill 1-Tap payment requested does not exist 
MAX REQ REACHED Too many failed Skrill 1-Tap payment requests to the API. For security 


reasons, only two failed attempts per user per 24 hours are allowed 





MAX AMOUNT REACHED The payment amount is greater than the maximum amount configured 
when 1-Tap payments were set up for this user. 














Table 6-5: Errors when validating parameters 





Error Description 





INVALID OR MISSING ACTION | Wrong action or no action is provided 


























LOGIN INVALID Email address and/or password were not provided 
INVALID REC PAYMENT ID Invalid recurring payment ID is submitted by the merchant 
MISSING EMAIL Provide registered email address of merchant account 
MISSING PASSWORD Provide correct API/MQI password 

MISSING AMOUNT Provide amount you wish to send 

MISSING CURRENCY Provide currency you wish to send 

MISSING BNF EMAIL Provide email address of the beneficiary 

MISSING SUBJECT Provide subject of the payment 
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Table 6-5: Errors when validating parameters (Continued) 





Error Description 





MISSING NOTE Provide notes for the payment 














6.6.2. Execute payment step 
Action parameter: action=request 


Now that you have received a session ID you can execute the actual payment transaction using the 
request action. The URL is the same as before. The following parameters are required: 


Table 6-6: Parameters to include with the request 











Field name Description Required | Example value 

sid Session identifier returned in response to the Yes 7783bfa23641a627 
prepare request. e4a5f79f2b7c6 

action The required action (i.e., prepare). Yes request 




















Upon success, Skrill returns the details of the transaction as an XML response. This response contains 
the following fields: 


Table 6-7: Fields provided in the XML response 




















Field name Description Example value 
amount Amount requested 10.50 
currency 3-letter currency code of the amount, according to ISO 4217 EUR 
id Transaction ID 500123 
status Skrill 1-Tap payment status: 2 

2 — processed 

-2 — failed 
status msg Text description of the status. processed 
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Notes: 


e Ifarequest fails, you are not allowed to make more than two requests for a debit of a customer’s 
account using a Skrill 1-Tap payment per customer per 24 hours. 


e The customer is notified via email for every Skrill 1-Tap payment request executed. 


Example 1: Successful request 


Below is an example of a successful request. 


Request 
POST https://www.skrill.com/app/ondemand_request.pl 


Header 
Content-Type: application/x-www-form-urlencoded 


Body 
sid=84034fe3e5c9f6ef54e5blefbbe9f27678action=request 





Response 





<?xml version="1.0" encoding="UTF-8"?> 
<response> 
<transaction> 
<amount>10.34</amount> 
<currency>EUR</currency> 
<id>1668624876</id> 
<status>2</status> 
<status msg>processed</status msg> 
</transaction> 
</response> 





Example 2: Failed request 


This example shows a request that failed, due to an expired session ID. 


Request 
POST https://www.skrill.com/app/ondemand_request.pl 


Header 
Content-Type: application/x-www-form-urlencoded 


Body 


sid=123&action=request 


Response 


<?xml version="1.0" encoding="UTF-8" ?> 
<response> 
Error 
<error msg>SESSION EXPIRED</error msg> 
</error> 
</response> 
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6.7. Checking or cancelling 1-Tap payments 


You can use the Merchant Query Interface (MAI) to review the status of a 1-Tap payment or to cancel 


it so that no more 1-Tap payments can be taken. 
You can access the MQI by posting an HTTPS GET/POST query to: 


https://www.skrill.com/app/query.pl 


The MQI requires three general parameters to be included in your query (email, password, and 
action) and a number of parameters specific to the requested action (see the Additional Parameters 


table for each action below) 


Table 6-8: General parameters 





























Field name Description Required | Example value 

email The email address linked to your Skrill account Yes info@example.com 

password The lowercase hex MD5 of your API/MQI password Yes 9f535b6ae672f627e 
4e5f79f2b7c63fe 

action The required action (i.e., prepare). Yes request 

amount The amount of the request for a debit transaction Yes 10.50 








6.7.1. Cancel Skrill 1-Tap payment 


Action parameter: action=cancel_od 


This action allows you to cancel a Skrill 1-Tap payment. The following additional parameter is 


required: 


Table 6-9: Additional parameters - Cancel a 1-Tap payment 





Field name Description 


Required 


Example value 





trn_id Your transaction ID. This is the transaction id value 
you provided for the initial setup 1-Tap payment. If 
you did not provide a transaction_id parameter this 
will be the transaction id parameter returned to 
your status_url page once the initial setup 1-Tap 
payment is complete 











Yes 





500123 








Request 
POST https://www.skrill.com/app/query.pl 


Header 
Content-Type: application/x-www-form-urlencoded 
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action=cancel od&email=infofexample.com&password=9f535b6ae672f627e4a5f79f2b7c63fest 





rn id=500123 


Response 
POO = = 


Where an arrow symbolises a tab character. 


Using escape sequences to represent special characters: 


200\t\tOK\n\n 


6.7.2. Get Skrill 1-Tap payment status 


Action parameter: action=status_od 


This action allows you to cancel a Skrill 1-Tap payment. The following additional parameter is 


required: 


Table 6-10: Additional parameters - Check 1-Tap payment status 





Field name 


Description 


Required 


Example value 





trn_id 








Your transaction ID. This is the transaction_id value 
you provided for the initial setup 1-Tap payment. If 
you did not provide a transaction_id parameter this 
will be the transaction_id parameter returned to 
your status_url page once the initial setup 1-Tap 
payment is complete 





Yes 





500123 








If a transaction with the supplied ID is found, the response will contain the following parameters on 
the second line of the response: 


e Status: O — active; -1 — cancelled 


e Last execution date in dd-mm-yyyy format or '--' if no subsequent payments have been taken 
(payments after the initial setup) 
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Example 1: Check status of a cancelled 1-Tap payment 


Request 
POST https://www.skrill.com/app/query.pl 


Header 
Content-Type: application/x-www-form-urlencoded 


Body 


action=status od&email=infotexample.com&password=9f535b6ae672f627e4a5f79f2b7c63feat 
za ate SO ZS) 





Response 


200 = = OK 
Status: -1 Last execution date: 08-01-2017 


Note: The arrows above represent tab characters. There are two spaces between the Status value 
and the word Last. 


Using escape sequences to represent special characters: 


200\t\tOK\nStatus: -1 Last execution date: 08-01-2017\n 


Note: The arrows above represent tab characters. There are two spaces between the Status value 
and the word Last. 


Example 2: Check status of an active 1-Tap payment with invalid transaction 


Request 
POST https://www.skrill.com/app/query.pl 


Header 
Content-Type: application/x-www-form-urlencoded 


Body 


action=status od&email=infotexample.com&password=9f535b6ae672f627e4a5f79f2b7c63feat 
rn id=123 





Response 


403 = = Transaction not found: 123 


Using escape sequences to represent special characters: 


403\t\tTransaction not found: 123\n 


Note: The above response still returns a 200 HTTP response status code 
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6.7.3. MQI Error Messages 


The following error messages can be returned by the Merchant Query Interface (MAI): 


Table 6-11: MQl error messages 














Error Description Reason for error 

401 Unauthorised/ Cannot log in Authentication is required and has failed or has not yet been 
provided. 

402 Payment Required Reserved for future use. 

403 Forbidden The request was a valid request, but the server is refusing to 


respond to it. For example, the provided credentials were 
successfully authenticated but do not grant the client 
permission to access the resource. 





404 Not Found The requested resource could not be found. 





405 Method not Allowed A request was made of a resource using a request method 
not supported. For example, using GET on a method which 
requires data to be presented via POST. 
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7. ASTROPAY 


This section explains the Skrill payment flow for the Astropay payment method available in Argentina, 
Brazil, Chile, Colombia, Mexico, Peru, and Uruguay. Astropay is composed of two subcategories: 


e Bank Transfer (two transfer types are available: Direct or Manual) 


e Cash/Invoice 


Note: Astropay is only available for payments greater than or equal to 10 USD. Contact Skrill 
Merchant Services to enable each of the different Astropay payment methods listed above. 


These categories are described in more detail below. Not all categories are supported in all the 
countries where Astropay is available, see List of banks supported by country on page 7-14 for a list 
of all the banks or cash payment networks that Astropay supports in each country and which 
payment category they support. If a country is not listed, it does not support Astropay. 


Astropay integration is the same as the standard Skrill integration, however, the merchant's 
integration code must handle interim pending payment status notifications and be prepared to 
receive the final payment success notification some days, weeks, or months later (in the case of cash/ 
invoice payment). 


The Skrill Quick Checkout payment form can show two Astropay tabs: Cash and Bank Transfer. The 
Bank Transfer tab is used for both Direct and Manual bank transfers. You can restrict which tabs are 
shown by using the Fixed Split Gateway option and the payment method codes listed in Astropay 
payment method codes on page 7-14. 


When a customer selects the appropriate tab they will see the logos of all supported banks (or in the 
case of Cash, supported payment networks) and a drop-down menu where they can select the bank 
or payment network they wish to use. If only one bank or payment network is supported in the 
customer's country, this logo will appear instead of Cash or Bank Transfer to increase conversion. 


If the merchant passes a payment method code, they can restrict the Bank Transfer page to only 
show Direct or Manual banks in the drop-down menu on the Bank Transfer tab, as appropriate. 


Finally, this section includes a description of the refund process which differs from the standard 
refund process as user action is required. 
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Bank transfer 


Direct bank transfer 


Direct bank transfer is the simplest method for customers. The payment flow is as follows: 


1. 


The customer clicks Pay by Bank Transfer on the merchant website and is redirected to the 
Skrill Quick Checkout payment form. The payment form can also be displayed in an iframe. 


The customer enters their first and last name (if these are not supplied by the merchant). 


The customer enters their National Identity number (this field has a different name 
depending on the country, e.g., CPF, RUT, ID, DNI). 


The customer selects a local bank in the Skrill payment form and clicks Proceed to Online 
Bank. The list of available banks depends on the country selected. If the bank supports Direct 
Bank Transfer the payment flow continues, otherwise, the flow will be as described in 
Manual bank transfer below. 


The customer is redirected to the chosen bank’s website where they can log in and approve a 
bank transfer to make payment. 


Once payment is complete, Skrill shows a successful payment form and sends a response 
containing the payment status to the merchant's status url. 


The customer clicks the button on the success form to return to the merchant website. The 
merchant website should check the payment status received at the status url for the 
payment to determine the message to show to the customer. 


When the merchant receives a valid payment confirmation with a status value of 2 at the 
merchant's status url they can release the goods to the customer. 


30.00vso A ACME 


Account holder name 


John Payer 


CPF 
10934510213 


Email addre 


john payordDskrill. cor 
PROCEED TO ONLINE BANK 


qu Siri 


Figure 7-1: Enter the name and ID number and select a bank 
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g Comércio Eletrônico - Melos de Pagamento 


Você esta efetuando ums ressação no aña do Basco do Brand pue erg o 
pegando de D'A, serviços cu DÉI, ões antes via terras. 


Loya reesen ASTROPAY BRASA 

Eetecén- a da Tamas ao PAIE 434 44] 

We Teta 119.40 
femcione a tus opção De pagamento 
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Autoatendimento 
Titular: = Como acessar? 
Ufer + > Náo possui ou esqueceu sua senha? 
Agência: Conta: > Requisitos mínimos 


> Termo de uso do autoatendimento 
1518-0 25718-4 


Senha de autoatendimento (8 dígitos): Outros acessos 


> Decora Veva 
> Deficiente Visual 


Caso nao possua senha, clique aqui > Utilizando certificado digital A3 
H ENTRAR i LIMPAR j Suporte Técnico 0800 729 0200 
Entrar 


Senha de Aúto-Atendimento: Conteúdo deve ter no mínimo 8 caracteres.... 


Serviço de Mensagens via E BB Conta de Pagamento 
Celular(SMS) <> sl Faça transferências até para quem 
Mais segurança e conveniência. GR não tem conta no BB. 

> Saiba mais > Saiba mais 


Figure 7-3: Log in to the bank to make a transfer 


Skrill Quick Checkout Integration Guide 8.1 


Confira os dados do seu pedido e confirme 


seu pagamento 

Crédito 
Loja Conveniada : ASTROPAY BRASIL 
Referência da 25167530003038140 
Transação : 
Valor Total : 2,60 
Débito 
Agência ` 1518-0 
Conta : 257184 
Nome KELLI ANDRESSA 

RIBEIRO PINTO 
Data : 13/08/2014 


Para aumentar ainda mais sua segurança, 
esta transação deve ser confirmada com a 
senha da conta corrente. 


Go? 


Figure 7-4: Re-enter your password 





Crédito 

Loja Conveniada : ASTROPAY BRASIL 

Referéncia da Transagáo : 25167530003038140 

Valor Total : 2,60 

Débito 

Agência : 1518-0 

Conta : 25718-4 

Nome KELL! ANDRESSA 
RIBEIRO PINTO 

Data 13/08/2014 

Autenticação SISBB: 978577 
Transagáo efetivada com sucesso! 


| CONFIRMAR O PAGAMENTO NA LOJA ] 1 IMPRIMIR | 


t 


Voltar para loja 


Figure 7-5: Review payment details and confirm payment 
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30.00uso A. ACME 


Y 





Successful payment 


Gem Sei 


Figure 7-6: Successful payment 


Manual bank transfer 


The manual bank transfer payment flow is as follows: 


1; 


The customer clicks Pay by Bank Transfer on the merchant website and is redirected to the 
Skrill Quick Checkout payment form. Note that the payment form can also be displayed in an 
iframe. 


The customer selects a local bank from a drop-down menu in the payment form (the list of 
available banks depends on the country selected). If the bank supports Manual Bank Transfer 
the payment flow continues, otherwise, the flow will be as described in Direct Bank Transfer 
above. 


The customer clicks Proceed to Online Bank. A form is displayed showing the manual bank 
transfer details required to complete the payment. Note that the amount will always be 
displayed in the local currency in that country rather than the currency selected in the 
merchant website. The transfer details will always be displayed in the local language. 


The customer clicks on Do Transfer (Realizar Transferencia in Spanish) to be redirected to the 
selected bank's website where they can manually complete the payment. 


Once the transfer is complete, the customer clicks Already Deposited (Ya Desposité in 
Spanish) in the Skrill payment form and a pending notice is shown on the Skrill payment form. 
This informs customer that payment is pending. 


The customer can now click the Continue button to return to the merchant website. The 
merchant website should check the payment status received at the status_url for the 
payment to determine the message to show to the customer. 


Once payment is complete, Skrill receives confirmation and sends a payment success 
notification to the merchant's status url. Note that this may take 1-2 days after the customer 
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has made the bank transfer. When the merchant receives a valid payment confirmation with 
a status value of 2 at their status url they can release the goods to the customer. 


SE spañol 


30.00uso A ACME 


Banco 
Santander 


Titular de la cuenta 
John Payer 


CPF 


PROCEDER A BANCO ONLINE 


Powered by 


g== Skrill 


Figure 7-7: Enter a name and ID and select a bank 
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Skrill > 


Santander 





Lea cuidadosamente las instrucciones de depósito para completar su 
pago. Cualquier error puede provocar demoras en la acreditación del pago. 


Relice la transferencia 
Deposite el valor exacto d ARS 182.55 (incluyendo decimales) 


antes de las 23.59 del comente dia en nuestra cuenta bancaria 


Datos Bancarios para Realizar la Trasferencia: 





Banco SANTANDER RIO 

Cuenta Unica 168-012044/3 

CBU 0720168020000001204436 
CUIT/DNI 33714595569 

Beneficiario WEBPAY SRL 

Referencia 8880580 


Realizar Transferencia 


Continue con su compra 


Al completar la transferencia deberá hacer click en el botón “Ya deposité” en 
nuestro sitio a modo de completar su proceso de pago. 


Ya deposité 


Figure 7-8: Bank account details for manual transfer 








a Sa 


ntander Río Online Banking Personas 





Ingresá desde aqui 
para operar 






Bienvenido a . 
Online Banking d 





ça INGRESAR > 
EN 
e 
A 
A 
F - 
Ve 
bs À p en Si ya operas con Online Banking 


Figure 7-9: Log in to bank to make a manual transfer (not shown) 
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Pago pendiente 


Las transtorencias bancanas során confirmadas 
una vez quo el pago haya sido remitido por su 
banco. Este proceso puede tardar uno q dos días 
Imnscumdos los cuales el pago estará completado 


g= Skrili 


Figure 7-10: Pending payment shown after clicking Already Paid 
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7.2. Cash/Invoice 


The cash payment flow is as follows: 


1. The customer clicks Pay by Cash/ Invoice on the merchant website. They are then redirected 
to the Skrill Quick Checkout Payment form (or this form is displayed in an iframe/lightbox). 


2. The customer selects a local bank/payment network from the drop-down menu (the list of 
available banks depends on the country selected). 


3. The customer enters their first and last name (if these are not supplied by the merchant). 


4. The customer enters their National Identity number (This field has a different name 
depending on the country, for example: CPF, RUT, ID, DNI, etc.) 


5. The customer is redirected to the bank/payment network website for confirmation. 
6. The bank/payment network website displays a bar code that the customer must print. 


7. The customer goes to the bank or a store which belongs to the payment network and pays in 
cash using the bar code they were given in step 6. Alternatively, they can pay the invoice 
using their online banking. 


8. Once payment is complete, Skrill receives the confirmation. Skrill sends a payment success 
notification to the merchant's status url. 


9. Once the merchant receives a valid payment confirmation with a status value of 2 at the 
merchant’s status_url they can release the goods to the customer. 


30.00uso A ACME 


Skrin =) so.» PUMA] 
-8$ orm 


ge Sil 
Figure 7-11: Select bank and enter name and ID number 


Note: If only a single cash method is supported for the customer’s country instead of a list of banks to 
select from, only the option and logo of the single payment method is shown. For details of 
countries supporting cash payments, see List of banks supported by country on page 7-14. 
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Recibo de pago referenciado 


(Banner | E] Powered By: Tikrel 


Datos del Pago 





Descripción: ID : 8830047 
Valor: $18700 COP 


Datos Del Usuario: 


Documento Usuario | 123045078 | 
Nombre | 
































OO riera 


Tiene alguna duda sobre su código de pago? escriba a support@astropay.com Online Payment Solution 


Figure 7-12: Redirect to the bank or payment network website for confirmation 


20888 AE 


(Banner Recibo de pago referenciado 
E] Powered By: Tikrel 


Datos del Pago 





Descripción: ID : 8760133 
Valor: $3800 COP 


Datos Del Usuario: 


Documento Usuario 12304567 
Nombre 
Correo 


Metodos de pago Habilitados: 





| Pago En Efectivo-Exito-Baloto ¥ 


Pago En Efectivo-Exito-Baloto 








| Imprimir Codigo Barras || Finalizar | 





Figure 7-13: Customer confirmation (Continued) 
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RECAUDO EXPRESS UN PRODUCTO TUCOMPRA 
Tikrel Colombia SAS - 
REFERENCIA DE PAGO: 1011013738 


CONSECUTIVO DEL COMERCIO: 8760133 
PAGADOR: 


VALORA CANCELAR 3800 


20160422 3800 
1. ESTE RECIBO ES VALIDO CON EL SELLO DEL PAGO Y CONFIRMADO POR EL MISMO 


2. NO SE ACEPTAN PAGOS DESPUES DE LA FECHA DE PAGO MAXIMO. 
3. EL PAGO DE ESTE RECIBO NO MODIFICA LAS CONDICIONES DEL CONTRATO CON EL COMERCIO 


PARA SU COMODIDAD PUEDE REALIZAR EL PAGO DE SU FACTURA EN CUALQUIERA DE 
ESTOS MEDIOS 


GVA Toda nora 5. A. 


CAJEROS AUTOMATICOS 
poep 


POMONA 


[GENERADO POR TU COMPRADAS "EI tee CLIENTE 









REFERENCIA DE PAGO: 
1011013738 


CONVENIOS 








FECHA 20160422 


00 


(415)7709998205406(8020)101 1013738(3900)00003800(96)20160422 


Figure 7-14: Bar code for payment 
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30.00vs0 A ACME 


Y 





Pago pendiente 


g= Skriti 
Figure 7-15: Pending payment 


7.3. Refunds 


Astropay supports full and partial refunds. Customers receive an email when the merchant triggers a 
refund. This email contains a link to a form on the Astropay website with a Skrill logo where 
customers specify their name, bank account, and the security code contained in the email. Astropay 
will then send a refund to the customer’s bank. Refunds take up to two working days from receipt of 
these details. 


When the refund is executed by the merchant, an email is sent to the customer and the refund is set 
to pending. The refund status changes to processed when the customer provides their bank account 
details and Astropay sends the payment to their bank. Note that payment will still take up to two 
working days to reach the customer's account. 


Warning: If you use the refund call in the Skrill Automated Payment Interface you must ensure that 
your provide a refund_status_url to record the change from pending to processed. 
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Skrill 


Hola: John Payer 


Recibimos una solicitud para realizar el reembolso de COP 96138.03 frente a su pedido en el sitio de paysafe 
El plazo para recibir el reembolso es de 2 dias habiles a partir del envio de los datos bancarios. 


Para que efectuemos el depósito, es necesario que usted nos informe de sus datos bancarios accediendo al siguiente link: 
CLICK AQUÍ PARA COMPLETAR SUS DATOS PARA EL REEMBOLSO 
Código de seguridad:215107 


Atención: el link solo puede ser utilizado dos veces. 


Gracias por utilizar a AstroPay como su procesador de pagos. 


En el caso de que desconozca cualquier pago realizado para este sitio. ignore este e-mail y este reembolso sera cancelado 
automaticamente. 


Figure 7-16: Customer receives refund email 


Skrill 


Formulario de reembolso 


Total del reembolso en COP: 


ates DETALLES DE LA TRANSACCION 
titular Reterencia: 9399144 
Danana: ee Invoice: 1781369702 
Valor USD: 31.00 USD 
Nombre del banco: 
Monto local: 96138 03 COP 
Número de agencia: 
Código de 
À seguridad: 
Número de cuenta bancaria: 
Tipo de cuenta: D 


Comentarios: 


ENVIAR 


El reembolso será procesado hasta dos dias hábiles luego del envio de los datos bancarios 


Figure 7-17: Customer completes refund form 
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7.4. Astropay payment method codes 
The following table lists the Payment Method Codes for Astropay and their effects. These codes can 
be used with the Fixed Split Gateway option to launch the payment form with a single Astropay tab. 
They are also returned in the payment type parameter in both Gateway types (Fixed or Flexible, 


where enabled) to show which Astropay payment type the customer used. 


Table 7-1: Payment method codes 




















Transfer Type | Fixed Split Gateway Effect Payment Method 
Direct Bank Shows the Bank Transfer payment tab. The bank ADB 
Transfer selector only shows those banks in the customer's 
country which support Direct Bank Transfer rather 
than all banks. 
Manual Bank | Shows the Bank Transfer payment tab. The bank AOB 
Transfer selector only shows those banks in the customer’s 
country which support Manual Bank Transfer rather 
than all banks. 
Cash/Invoice Shows the Cash payment tab. ACI 











7.5. List of banks supported by country 


Note: This list may change. Contact Skrill before implementing this payment method for an up-to- 


date list. 


Table 7-2: Argentina 





Bank 


Type 





Santander Rio 


Direct bank transfer 


























Red Link Cash 
Pago Fácil Cash 
Table 7-3: Brazil 
Bank Type 
Itau Direct bank transfer 





Banco do Brasil 


Direct bank transfer 




















Bradesco Direct bank transfer 
HSBC Manual bank transfer 
Caixa Manual bank transfer 
Santander Manual bank transfer 
Boleto Cash 











O Skrill 2021 


Skrill Quick Checkout Integration Guide 8.1 


Note: The Quick Checkout payment form does not currently support Portuguese. Customers must 


use another supported language such as English or Spanish. 
















































































Table 7-4: Chile 
Bank Type 
webpay Manual bank transfer 
Servipag Cash 
Table 7-5: Colombia 
Bank Type 
Bancolombia Manual bank transfer 
PSE Manual bank transfer 
Efecty Cash 
Davivienda Cash 
Almancenes Éxito Cash 
Carulla Cash 
Empresa de Energia del Quindio Cash 
Surtimax Cash 
Table 7-6: Mexico 
Bank Type 
OXXO Cash 
BBVA Bancomer Cash 
Banamex Cash 
Santander Cash 
Table 7-7: Peru 
Bank Type 
BBVA Cash 
BCP Cash 
InterBank Cash 
Pago Efectivo Cash 
ScotiaBank Cash 
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Bank Type 

Western Union Cash 
Table 7-8: Uruguay 

Bank Type 

Red Pagos Cash 
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8. APPENDIX 


This appendix contains the following information: 


ISO 4217 currencies 
Language support 

ISO country codes (3-digit) 
MDS signature 

SHA2 signature 

Example HTML forms 
Payment method codes 


Failed reason codes 
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8.1. ISO 4217 currencies 

Table 8-9: ISO 4217 currencies accepted by Skrill 
EUR Euro KRW South-Korean Won 
USD U.S. Dollar KWD Kuwaiti Dinar 
AED Utd. Arab Emir. Dirham MAD Moroccan Dirham 
AUD Australian Dollar MYR Malaysian Ringgit 
BGN Bulgarian Leva NOK Norwegian Krone 
BHD Bahraini Dinar NZD New Zealand Dollar 
CAD Canadian Dollar OMR Omani Rial 
CHF Swiss Franc PEN Peru Sol 
COP Colombian Peso PLN Polish Zloty 
CZK Czech Koruna QAR Qatari Rial 
DKK Danish Krone RON Romanian Leu New 
GBP British Pound RSD Serbian Dinar 
HKD Hong Kong Dollar SAR Saudi Riyal 
HRK Croatian Kuna SEK Swedish Krona 
HUF Hungarian Forint SGD Singapore Dollar 
ILS Israeli Shekel THB Thailand Baht 
INR Indian Rupee TND Tunisian Dinar 
ISK Iceland Krona TRY New Turkish Lira 
JOD Jordanian Dinar TWD Taiwan Dollar 
JPY Japanese Yen ZAR South-African Rand 
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Skrill supports the following languages (2-character ISO codes): 





























Table 8-10: 2-digit ISO language codes 
BG Bulgarian JA Japanese 
cs Czech NL Dutch 
DA Danish PL Polish 
EL Greek PT Portuguese 
EN English RO Romanian 
ES Spanish RU Russian 
FI Finnish SV Swedish 
FR French TR Turkish 
IT Italian ZH Chinese 
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ISO country codes (3-digit) 


Skrill does not accept customers from the following countries: Afghanistan, Cuba, Eritrea, Iran, Iraq, 


Japan, Kyrgyzstan, Libya, North Korea, Sudan, South Sudan, and Syria. 


Table 8-11: 3-digit ISO country codes 





































































































ABW | Aruba GHA Ghana NIU Niue 
AGO | Angola GIB Gibraltar NLD | Netherlands 
AIA Anguilla GIN Haiti NOR | Norway 
ALA | Aland Islands GLP Guadeloupe NPL Nepal 
ALB | Albania GMB | Gambia NZL New Zealand 
ano “sor A [om | Or 
ANT | Netherlands Antilles GNQ Equatorial Guinea PAK | Pakistan 
ARE | United Arab Emirates | GRC Greece PAN | Panama 
ARG | Argentina GRD Grenada PCN Pitcairn 
ARM | Armenia GRL Greenland PER Peru 
ASM | American Samoa GTM Guatemala PHL Philippines 
ATA | Antarctica GUF French Guiana PLW | Palau 
ATE e GUM Guam PNG Papua New Guinea 
ATG Antigua and Barbuda GUY Holy See (Vatican City POL Poland 
State) 
AUS | Australia HKG Hong Kong PRI Puerto Rico 
AUT | Austria HMD | Guinea-Bissau PRT Portugal 
AZE Azerbaijan HND Honduras PRY Paraguay 
BDI Burundi HRV Croatia PSE Palestinian Territory 
BEL Belgium HTI Guinea PYF French Polynesia 
BEN Benin HUN Hungary QAT | Qatar 
BFA | Burkina Faso IDN Indonesia REU | Reunion 
BGD | Bangladesh IMN Isle of Man ROU | Romania 
BGR | Bulgaria IND India RUS Russian Federation 
BHR | Bahrain IRL Ireland RWA | Rwanda 
BHS | Bahamas ISL Iceland SAU | Saudi Arabia 
BIH Sn ISR Israel SEN Senegal 
BLR Belarus ITA Italy SGP Singapore 
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Table 8-11: 3-digit ISO country codes (Continued) 








































































































pz fen am (UMES e | South Sandwich sland 

BMU | Bermuda JEY Jersey SHN | Saint Helena 

BOL Bolivia JOR Jordan SIM Svalbard and 
JanMayen 

BRA | Brazil JPN Japan SLB Solomon Islands 

BRB | Barbados KAZ Kazakhstan SLE Sierra Leone 

BRN | Brunei Darussalam KEN Kenya SLV El Salvador 

BTN | Bhutan KHM | Cambodia SMR | San Marino 

BVT | Bouvet Island KIR Kiribati SOM | Somalia 

BWA Botswana KNA Saint Kitts and Nevis SPM Saint Pierre and 
Miquelon 

CAF a KOR Korea, Republic of SRB Serbia 

CAN | Canada KWT Kuwait STP Sao Tome and Principe 

CCK Cocos (Keeling) Islands LAO E oie SUR Suriname 

CHE | Switzerland LBN Lebanon SVK | Slovakia 

CHL | Chile LBR Liberia SVN | Slovenia 

CHN | China LCA Saint Lucia SWE | Sweden 

civ e LIE Liechtenstein swz Swaziland 

CMR | Cameroon LKA Sri Lanka SYC Seychelles 

cop Ge Democratic LSO Lesotho TCA a Caicos 

COG | Congo, Republic of LTU Lithuania TCD Chad 

COK | Cook Islands LUX Luxembourg TGO | Togo 

COL | Colombia LVA Latvia THA | Thailand 

COM | Comoros MAC Macao TJK Tajikistan 

CPV Cape Verde MAE o Martin (French TKL Tokelau 

CRI Costa Rica MAR | Morocco TKM | Turkmenistan 

CXR | Christmas Island MCO | Monaco TLS East Timor 

CYM | Cayman Islands MDA | Moldova TON | Tonga 

CYP Cyprus MDG | Madagascar TTO | Trinidad and Tobago 

CZE Czech Republic MDV | Maldives TUN | Tunisia 





O Skrill 2021 





Skrill Quick Checkout Integration Guide 8.1 


Table 8-11: 3-digit ISO country codes (Continued) 

























































































DEU | Germany MEX Mexico TUR | Turkey 

DJI Djibouti MHL Marshall Islands TUV | Tuvalu 

DMA | Dominica MKD | Macedonia TWN | Taiwan 

DNK | Denmark MLI Mali TZA | Tanzania 

DOM | Dominican Republic MLT Malta UGA | Uganda 

DZA | Algeria MMR | Myanmar UKR | Ukraine 

ECU Ecuador MNE Montenegro UMI a” 

EGY Egypt MNG | Mongolia URY | Uruguay 

ERI Eritrea MNP Northern Mariana USA United States 
Islands 

ESH Western Sahara MOZ | Mozambique UZB | Uzbekistan 

ESP Spain MRT Mauritania VAT | Guyana 

EST Estonia MSR Montserrat VCT Saint Vincent and the 

Grenadines 

ETH Ethiopia MTQ | Martinique VEN | Venezuela 

FIN Finland MUS Mauritius VGB | Virgin Islands, British 

FJI Fiji MWI Malawi VIR Virgin Islands, U.S. 

FLK Falkland Islands MYS Malaysia VNM | Viet Nam 

FRA France MYT Mayotte VUT | Vanuatu 

FRO | Faroe Islands NAM | Namibia WLF | Wallis and Futuna 

FSM e Federated NCL New Caledonia WSM Samoa 

GAB | Gabon NER Niger YEM | Yemen 

GBR | United Kingdom NFK Norfolk Island ZAF South Africa 

GEO | Georgia NGA Nigeria ZMB | Zambia 

GGY | Guernsey NIC Nicaragua ZWE | Zimbabwe 
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8.4. MD5 signature 


A hidden text field called md5sig is included in the form submitted to your server. The value of this 
field is a 128-bit message digest, expressed as a string of thirty-two hexadecimal digits in UPPERCASE. 
The md5sig is constructed by performing an MD5 calculation on a string built up by concatenating the 
fields returned to your status_url page. This includes: 


e merchant id 
e transaction id 


e the uppercase MDS value of the ASCII equivalent of the secret word submitted in the Settings 
> Developer Settings section of your online Skrill account. 


e mb amount 
e mb currency 
e status 


The purpose of the md5sig field is to ensure the integrity of the data posted back to your server. You 
should always compare the md5sig field's value posted by Skrill's servers with the one you calculated. 


To calculate the md5sig, you need to take the values of the fields listed above exactly as they were 
posted back to you, concatenate them, and perform a MDS calculation on this string. 


Cancelled payment 


The MDS hash posted on the ondemand status url when a Skrill 1-Tap payment has been cancelled 
is a concatenation of the following fields: 


e MERCHANT_ID = merchant_id 
e MERCHANT TRN ID=transaction id 


e The uppercase MDS value of the ASCII equivalent of the secret word submitted in the 
Settings > Developer Settings section of the Merchant’s online Skrill account 


e REC_PMT_STATUS = status 
e TRN ID=rec payment id 


The MDS hash for 1-Tap payments, posted on the status urlis calculated the same way as normal 
payments/refunds. 


Secret word 


The secret word must be submitted in the Settings > Developer Settings section of your Skrill Digital 
Wallet account before the md5sig can be used. The following restrictions apply when submitting your 
secret word: 


e All characters must be in lowercase 
e The length should not exceed 10 characters 


e Special characters are not permitted (for example O, %, $, etc.) 


Note: If the Settings > Developer Settings section is not displayed in your account, contact 


merchantservices@skrill.com. 


© Skrill 2021 8-6 


Skrill Quick Checkout Integration Guide 8.1 


8.5. SHA2 signature 


To improve the security of the status reports, Skrill posts an additional parameter with the report 
called sha2sig. This is constructed in the same way as the md5 signature, but with a different hashing 
algorithm, Sha2 (256 bits). 


Note: This new parameter is not available by default. To enable this option, send a request to 


merchantservices@skrill.com. 


8.6. Example HTML forms 


Below are two examples of HTML forms that can be submitted to Skrill. The first one is a basic 
example. The second example uses several additional features currently available with Quick 
Checkout. 


You can use these forms, ensuring that the values are replaced with your own values. 
Note: To request a test account and test data, contact merchantservices@skrill.com. 


Simple HTML form 


<form action="https://pay.skrill.com" method="post" target="_blank"> 
<input type="hidden" name="pay to email" value="demogco@sun-fish.com"> 
<input type="hidden" name="status url" value="https://example.com/ 
process payment.cgi"> 








ct 




















<input type="hidden" name="language" value="EN"> 

<input type="hidden" name="amount" value="39.60"> 

<input type="hidden" name="currency" value="GBP"> 

<input 1196 alelolsia” incite dera lil desearia" metteg ee ee eran "> 
<input type="hidden" name="detaill text" value="Romeo and Juliet (W. 


Shakespeare) "> 
<input type="submit" value="Pay!"> 
</form> 
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//pay.skrill.com" method="post" target="_blank"> 











="pay to email" value="demogco@sun-fish.com"> 
EE 


="return url" value="https://example.com/ 





="cancel url" value="https://example.com/ 














="status url" value="https://example.com/ 





="language" value="EN"> 


="merchant fields" value="customer number, session id"> 








el euS Emer minos” valme"C 1234 


"session RE 





























="pay from email" value="payer123@skrill.com"> 

ll emeng lee eent) yalve=t Erover elas > 
="amount2" value="29.90"> 

="amount3 description" value="Handling Fees & Charges:"> 
="amount3" value="3.10"> 

="amount4 description" value="VAT (20%) :"> 

="amount4" value="6.60"> 

="amount" value="39.60"> 


="currency" value="GBP"> 











="firstname" value="John"> 
="lastname" value="Payer"> 





="address" value="Payerstreet"> 












































| code" value="EC45MQ"> 
value="Payertown"> 


="country" value="GBR"> 


li leegent era vealue="Booluer 103 "> 
11 text" value="4509334"> 

12 description" value="Description:"> 
12 text" value="Romeo and Juliet (W. 


l3 description” valus=" Special Conditions. > 
LS texti value=" 5-6 Cays dor delivery" > 





<form action="https: 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
payment finished.html"> 
<input type="hidden" nam 
payment cancelled.html"> 
<input type="hidden" nam 
process payment.cgi"> 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" nam 
<input type="hidden" name="postal 
<input type="hidden" name="city" 
<input type="hidden" nam 
<input type="hidden" name="detail 
<input type="hidden" name="detail 
<input type="hidden" name="detail 
<input type="hidden" name="detail 
Shakespeare) "> 
<input type="hidden" name="detail 
<input type="hidden" name="detail 
<input type="submit" value="Pay!"> 


</form> 
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8.7. Payment method codes 


The table below describes the codes required for each payment method if passing specific payment 
methods in your payment request. 


Table 8-12: Payment method codes 











Payment method Value Supported countries 

Skrill Digital Wallet WLT Allin table ISO country codes (3-digit) on 
page 8-3 

Neteller * + NTL All except for: 


Afghanistan, Armenia, Bhutan, Bouvet Island, 
Myanmar, China, (Keeling) Islands, Democratic 
Republic of Congo, Cook Islands, Cuba, Eritrea, 
South Georgia and the South Sandwich Islands, 
Guam, Guinea, Territory of Heard Island and 
McDonald Islands, Iran, Iraq, Cote d'Ivoire, 
Kazakhstan, North Korea, Kyrgyzstan, Liberia, 
Libya, Mongolia, Northern Mariana Islands, 
Federated States of Micronesia, Marshall 
Islands, Palau, Pakistan, East Timor, Puerto Rico, 
Sierra Leone, Somalia, Zimbabwe, Sudan, Syria, 
Tajikistan, Turkmenistan, Uganda, United 
States, US Virgin Islands, Uzbekistan, and Yemen 





Paysafecard * PSC American Samoa, Austria, Belgium, Canada, 
Croatia, Cyprus, Czech Republic, Denmark, 
Finland, France, Germany, Guam, Hungary, 
Ireland, Italy, Latvia, Luxembourg, Malta, 
Mexico, Netherlands, Northern Mariana Islands, 
Norway, Poland, Portugal, Puerto Rico, 
Romania, Slovakia, Slovenia, Spain, Sweden, 
Switzerland, Turkey, United Kingdom, United 
States Of America, and US Virgin Islands 



































Paysafecash * PCH Austria, Croatia, Hungary, Italy, Malta, Portugal, 
Romania, Slovenia, Spain 

Credit/Debit Cards 

All card types available in the ACC Allin table ISO country codes (3-digit) on 

customer's country page 8-3 

Visa VSA Allin table ISO country codes (3-digit) on 
page 8-3 

Mastercard MSC Allin table ISO country codes (3-digit) on 
page 8-3 

Visa Electron VSE Allin table ISO country codes (3-digit) on 
page 8-3 (excluding US) 

Maestro MAE United Kingdom, Spain, Ireland, and Austria 

Carte Bleue GCB France 

Dankort DNK Denmark 
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Payment method Value Supported countries 

PostePay PSP Italy 

CartaSi CSI Italy 

Instant Banking Options 

Rapid Transfer (Online Bank OBT/NGP Austria, Denmark, Finland, France, Germany, 

Transfer) Hungary, Italy, Norway, Poland, Portugal, Spain, 

(Previously called Skrill Direct) SEG SM Desde 
Note: NGP is returned in payment_type for this 
payment method only if detailed payment type 
information is enabled for your account. 

giropay GIR Germany 

Direct Debit/SEPA DID Germany 

Klarna (was Sofort) SFT Germany, Austria, Belgium, Netherlands, Italy, 
France, Poland, Hungary, Slovakia, Czech 
Republic and United Kingdom 

¡DEAL IDL/GCI Netherlands 
*Note: IDL is the only value allowed for this 
payment_method in a request. GCl is returned 
in payment_type for this payment method after 
a gaming payment through GlobalConnect, but 
only if detailed payment type information is 
enabled for your account. 

POLi PLI Australia 

Przelewy24 * PWY Poland 

ePay.bg EPY Bulgaria 

Trustly * GLU Austria, Belgium, Bulgaria, Czech Republic, 
Denmark, Estonia, Finland, Germany, Hungary, 
Ireland, Latvia, Lithuania, Netherlands, Poland, 
Romania, Slovakia, Slovenia, Spain, Sweden. 

Alipay * ALI Customer location: China only. 
This is available for merchants in all countries in 
table ISO country codes (3-digit) on page 8-3 
except China. 

Astropay - Online bank transfer | ADB Argentina, Brazil 

(Direct Bank Transfer) 

Astropay - Offline bank transfer | AOB Brazil, Chile, China, Colombia 

Astropay - Cash (Invoice) ACI Argentina, Brazil, Chile, China, Colombia, 
Mexico, Peru, Uruguay 

Rapyd RBR Brazil, Chile, Columbia, Mexico, Peru 











* - Payment method that supports Straight Through Redirect. 


O Skrill 2021 


Skrill Quick Checkout Integration Guide 8.1 


t- For the best user experience for the Neteller payment method, Skrill recommends that you 
provide a pay_from_email. However, you do not need to provide the pay_from_email if you use the 
Neteller customer’s email address in the neteller account parameter. 


8.7.1. Alipay 


The Alipay payment method is restricted to customers from China. 


Note: Only merchants outside China can offer this payment method 


The following currencies are supported: EUR, USD, GBP, HDK, and SGD. Other currencies will be 
processed but Skrill will convert the payment amount to Euros and charge the merchant a conversion 


fee, see https://www.skrill.com/en/fees/ for details. 


There are two integration options for Alipay: 


e Straight through redirect. 
e Payment tab selection. 


These methods are described in more detail below. 


Straight-through redirect 


A straight-through redirect bypasses the Quick Checkout form and sends the payment details direct 
to Alipay. To use this method you need to first ensure your merchant account is configured for the 
Fixed payment option. The next step is to provide the customer’s email in the pay from email 
parameter and pass a single payment_method code, ALI as part of the payment request. If you don’t 
pass the pay_from_email parameter, the Quick Checkout payment form will be displayed. The 
customer will see a prompt asking them to enter their email before continuing to Alipay. 


Payment tab selection 


If you use the Fixed payment option and pass more than one payment method code including the ALI 
code Alipay will appear as a standard payment tab on the form for Chinese customers. Alipay will also 
appear as a standard payment tab for Chinese customers if the merchant account is configured to use 
the Flexible payment option. 


8.7.2. Alipay customs declaration 


If you are shipping physical goods to customers in China paying with Alipay, you will need to make a 

customs declaration. This declaration should be made immediately after a successful payment. Skrill 
provide two MAI API calls for this purpose: one call to submit a customs declaration and a second call 
to check the status of an existing declaration. 


Before continuing, you must first enable the MAI, set up an API/MQI password, and specify an IP 
range from which MQI calls can be made. Refer to the introductory section of the Skrill Automated 
Payment Interface Guide for information about enabling and configuring the MAI. 


Once you have enabled the MQI, you can use the two calls. These calls are described in detail below. 
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Send a customs declaration 


This call sends a customs declaration about an Alipay purchase to Chinese customs. The request 
contains the merchant's Skrill account email and MQI/API password (in MD5 form) along with 
information about the payment such as transaction reference, amount, the merchant's identification 
details and the selected customs to which the purchased item will be shipped. Alipay verifies the 
request details to check that they match a successful payment registered in their system and then 
sends them on to Chinese customs. Finally, Alipay returns a response to the merchant (via Skrill) with 
the associated transaction ID for the payment (Alipay's transaction ID) and a customs declaration 
number. 




















Method Endpoint Description 
POST https://api.skrill.com/mqi/customs/ Send customs declaration to Alipay 
alipay/ customs API 





You should add the following header to your HTTP request: 


Content-Type: application/json; 


or 


Content-Type: application/json; charset="UTF8" 


if you are including UTF8 characters in the request. 
Example request: 


{ 
"email" : "merchant@sun-fish.com", 
"password" : "lbw8e40ebe9759b55948bbce8aaa460d", 
Jeunesse) > MiS, 
"outRequestNumber" : "9193457120563834", 
amenas gO 
"merchantCustomsCode" : "hanguo", 
"merchantCustomsName" : "jwyhanguo card", 
"customsPlace" : "HANGZHOU" 


Table 8-13: Request parameters 














Maximum 
Parameter length Required Description 
(bytes) 
email n/a Yes The email address of your merchant 
account. 
password n/a Yes MDS of the MQI/API password for your 
merchant account. 
transactionld n/a Yes The Skrill IDof the transaction for which 
you are making a customs declaration. 
This is the mb transaction id value 
received in the payment status response. 
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Maximum 
Parameter length Required Description 
(bytes) 
outRequestNumber 32 Yes Unique customs transaction ID. You must 
ensure that you generate a unique value 
for this field each time you make a 
request. 
amount n/a Yes Indicates the declared amount for 
customs in Yuan (CNY) to 2 decimal 
places, for example 20.00. This is the 
value of the goods and excludes all taxes 
and shipping costs. 
Note: This value should not exceed the 
payment transaction amount. 
merchantCustomsCode 20 Yes The merchant’s registration code at 
customs. 
merchantCustomsName | 256 Yes The merchant's registration name at 
customs. 
customsPlace N/A Yes The customs location at which the 


package is expected to arrive. Accepts the 
following values: 


HANGZHOU - Hangzhou Customs Dis- 
trict People's Republic of China. 
ZHENGZHOU - Zhengzhou Customs 
District of People's Republic of China 
(bonded logistics center). 
GUANGZHOU - Guangzhou Customs 
District People's Republic of China 
CHONGQING - Chongqing Customs 
District People’s Republic of China. 
NINGBO - Ningbo Customs District 
People’s Republic of China. 

HENAN - Customs in Henan (compre- 
hensive bonded zone). 








Example of a successful response: 


{ 
Melia yate a 


"alipayDeclarationNumber": 


OL SEO SONO LOS Za 


"2013112611001004680073956707", 


Table 8-14: Successful response parameters 





Parameter 


Description 





alipayTrnld 


The ID of the Alipay transaction. 








alipayDeclarationNumber 





The customs declaration serial number from Alipay. 
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A response of this form indicates that a successful customs declaration has been made. 
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Example showing a failed response from Alipay: 


{ 
Maita rare 
“errors 4 
"code": 
"message": 


not yet completed or hav 


} 
} 


"2013111511001004390000105126", 


"INVALID TRANSACTION STATUS", 
"Customs declaration is not allowed for transactions which are 


been refunded." 





Note: Both successful and failed responses return a HTTP 200 Status code. 


Example of a response with invalid parameters: 


{ 
error f 
"code": 
"message": 








"INVALID PARAMETER", 
"outRequestNumber must not exc 











d specified length" 


Table 8-15: Unsuccessful response parameters 


























Parameter Description 
code The error code. See Table 8-16 below for a list of values. 
message The detailed description of the error. See Table 8-16 below for a list of 
values. 
Table 8-16: Error codes 
Code Message 





INVALID_TRANSACTION_S 
TATUS 


Customs declaration is not allowed for transactions which are not yet 
completed or have been refunded. 





INVALID_PARAMETER 


Different descriptions are possible, based on which parameter is 
invalid. Here are some variants: 


e Invalid parameter format. 
e outRequestNumber must not exceed the specified length. 





OUT REQUEST NUMBER 
“ALREADY USED 


The same request number (out request number) is used for multiple 
requests. 





ALREADY DECLARED 


Customs declaration has already been registered. 





REQUEST AMOUNT EXCE 
EDED 


The declared amount exceeds the transaction amount. 





TRANSACTION NOT FOU 
ND 


This transaction is not found in Alipay's system. 





ALIPAY_COMMUNICATIO 
N_ERROR 


Error occurred during the communication with Alipay. 








MISSING_PARAMETER 








<parameter> must not be null or empty 
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Table 8-16: Error codes (Continued) 











Code Message 

CANNOT LOGIN No associated error message - this is used for incorrect password/ 
email errors 

BAD REQUEST Shows the line and column where the error occurred in the request 














Check the status of a customs declaration 


This call is used to return details about a customs declaration for a specific Skrill transaction. If a 
customs declaration exists for this transaction, the call returns a response with the associated 
transaction ID for the payment in Alipay's system and a customs declaration number. 








Method Endpoint Description 
GET https://api.skrill.com/mqi/customs/ Check the status of a customs 
alipay/{id} declaration 


/mqi/customs/alipay/ 
{id}?email={email}&password={password 


} 

















Example: 


https://api.skrill.com/mqi/customs/alipay/1705513403?email=merchant@sun- 
fish.com&password=1bw8e40ebe9759b55948bbce8aaa460d 


The parameters for this call are as follows: 
e email (required) - The email address of the merchant's Skrill account 
e password (required) - The MD5 of the merchant's password 


e id (required) - the Skrill transaction ID of the transaction that you want to query. This is the 
mb_transaction_id status response parameter. 


Note: Both successful and failed responses return a HTTP 200 Status code. 


Example of a successful response: 


{ 

Veio iaa" US SOLO DOLLS, 
"alipayDeclarationNumber": "2013112611001004680073956707", 

} 


Example of a failed response: 


{ 


Terrori / 
Heeler eNO TREO UND 
"message": "No transaction found with the specified id." 


} 
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8.8. Failed reason codes 


The table below contains all possible values of the failed reason code parameter and their 
corresponding meanings. Failed reason codes are mappings of codes Skrill receives from external 
processors and failures due to internal procedures. 


Table 8-17: Failed reason codes 




























































































Code Description 

01 Referred by Card Issuer 

02 Invalid Merchant. Merchant account inactive. 

03 Pick-up card 

04 Declined by Card Issuer 

05 Insufficient funds 

06 Merchant/NETELLER/Processor declined 

07 Incorrect PIN 

08 PIN tries exceed - card blocked 

09 Invalid Transaction 

10 Transaction frequency limit exceeded 

11 Invalid Amount format. Amount too high. Amount too low. Limit Exceeded. 

12 Invalid credit card or bank account 

13 Invalid card Issuer 

15 Duplicate transaction reference 

19 Authentication credentials expired/disabled/locked/invalid. Cannot authenticate. 
Request not authorized. 

20 Neteller member is in a blocked country/state/region/geolocation 

22 Unsupported Accept header or Content type 

24 Card expired 

27 Requested API function not supported (legacy function) 

28 Lost/stolen card 

30 Format Failure 

32 Card Security Code (CVV2/CVC2) Check Failed 

34 Ilegal Transaction 

35 Member/Merchant not entitled/authorized. Account closed. Unauthorized access. 

37 Card restricted by Card Issuer 

38 Security violation 

42 Card blocked by Card Issuer 
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Table 8-17: Failed reason codes (Continued) 


















































Code Description 

44 Card Issuing Bank or Network is not available 

45 Processing error - card type is not processed by the authorization centre 

51 System error 

58 Transaction not permitted by acquirer 

63 Transaction not permitted for cardholder 

64 Invalid accountld/country/currency/customer/email/field/merchant reference/ 
merchant account currency/term length/verification code. Account not found/ 
disabled. Entity not found. URI not found. Existing member email. Plan already 
exists. Bad request. 

67 BitPay session expired 

68 Referenced transaction has not been settled 

69 Referenced transaction is not fully authenticated 

70 Customer failed 3DS verification 

80 Fraud rules declined 

98 Error in communication with provider 

99 Other 
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